Track refunds

Refunds are child payments linked to a settled parent payment. Your system should show the refund timeline alongside the original payment, not as an unrelated transaction.

Note

Use parentPaymentId when a support agent or customer asks about a specific payment. Use identityId, accountNumber, status, and date filters for operations dashboards.

Flow

01

Locate parent

Start from the original settled payment ID.

02

List refunds

Filter refund children by parent payment.

03

Mirror state

Persist refund status and amount in your system.

04

Reconcile balance

Match final refund state with account movement.

List refunds for a payment

Request

HTTPcurlJavaScriptPythonGoRust

GET /sandbox/refunds?parentPaymentId=<PAYMENT_ID>&limit=50&offset=0 HTTP/1.1
Host: api.conomyhq.com
x-api-key: {YOUR_API_KEY}
Authorization: Bearer {ACCESS_TOKEN}
conomyhq-api-version: 24-04-2025
User-Agent: MyApp/1.0
Accept: application/json

curl -X GET 'https://api.conomyhq.com/sandbox/refunds?parentPaymentId=<PAYMENT_ID>&limit=50&offset=0' \
  -H 'x-api-key: {YOUR_API_KEY}' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'conomyhq-api-version: 24-04-2025' \
  -H 'User-Agent: MyApp/1.0' \
  -H 'Accept: application/json'

const response = await fetch('https://api.conomyhq.com/sandbox/refunds?parentPaymentId=<PAYMENT_ID>&limit=50&offset=0', {
  method: 'GET',
  headers: {
    'x-api-key': '{YOUR_API_KEY}',
    'Authorization': 'Bearer {ACCESS_TOKEN}',
    'conomyhq-api-version': '24-04-2025',
    'User-Agent': 'MyApp/1.0',
    'Accept': 'application/json',
  },
});

const data = await response.json();

import requests

response = requests.get(
    'https://api.conomyhq.com/sandbox/refunds?parentPaymentId=<PAYMENT_ID>&limit=50&offset=0',
    headers={
    'x-api-key': '{YOUR_API_KEY}',
    'Authorization': 'Bearer {ACCESS_TOKEN}',
    'conomyhq-api-version': '24-04-2025',
    'User-Agent': 'MyApp/1.0',
    'Accept': 'application/json',
    },
)

data = response.json()

package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.conomyhq.com/sandbox/refunds?parentPaymentId=<PAYMENT_ID>&limit=50&offset=0", nil)
	req.Header.Set("x-api-key", "{YOUR_API_KEY}")
	req.Header.Set("Authorization", "Bearer {ACCESS_TOKEN}")
	req.Header.Set("conomyhq-api-version", "24-04-2025")
	req.Header.Set("User-Agent", "MyApp/1.0")
	req.Header.Set("Accept", "application/json")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
}

use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let response = client
        .get("https://api.conomyhq.com/sandbox/refunds?parentPaymentId=<PAYMENT_ID>&limit=50&offset=0")
        .header("x-api-key", "{YOUR_API_KEY}")
        .header("Authorization", "Bearer {ACCESS_TOKEN}")
        .header("conomyhq-api-version", "24-04-2025")
        .header("User-Agent", "MyApp/1.0")
        .header("Accept", "application/json")
        .send()
        .await?;

    let data: serde_json::Value = response.json().await?;
    Ok(())
}

Response

200

{
  "results": [
    {
      "id": "<REFUND_PAYMENT_ID_2>",
      "parentPaymentId": "<PAYMENT_ID>",
      "type": "REFUND",
      "status": "RECEIVED",
      "purchaseAmount": "4000",
      "currency": "CLP"
    },
    {
      "id": "<REFUND_PAYMENT_ID_1>",
      "parentPaymentId": "<PAYMENT_ID>",
      "type": "REFUND",
      "status": "SETTLED",
      "purchaseAmount": "6000",
      "currency": "CLP"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 2
  }
}

Note

A parent payment can have several refund children. Their purchaseAmount values can sum up to (but never exceed) the parent’s totalAmount. Each child has its own lifecycle (RECEIVED → SETTLED).