v1

latestOpenAPI 3.1.02026-07-132363652.9 MB

Transactions

Create a cross-border refund for a transaction

post/api/v1/merchants/{merchantId}/transactions/{transactionId}/refunds

Path parameters

merchantIdstring uuid required

The unique identifier of the merchant

Example:123e4567-e89b-12d3-a456-426614174000

The unique identifier of the merchant

transactionIdstring uuid required

The unique identifier of the original transaction

Example:123e4567-e89b-12d3-a456-426614174000

The unique identifier of the original transaction

Request body

amountnumber required

Refund amount in the customer currency

reasonstring

Optional reason for the refund

Example request

{
  "amount": 100,
  "reason": "Customer request"
}

Response

Created

successboolean required

Example response

{
  "data": {
    "currency": {
      "code": "GBP",
      "symbol": "€",
      "name": "Euro",
      "minor_unit": 2
    },
    "payout_currency": {
      "code": "GBP",
      "symbol": "€",
      "name": "Euro",
      "minor_unit": 2
    },
    "payment_request": {
      "order_id": "ORD-2025-00123",
      "payment_token": "tok_abc123def456"
    },
    "merchant_webhook_deliveries": [
      {
        "event_type": "quidkey.payment_request.succeeded"
      }
    ],
    "fees": {
      "currency": {
        "code": "GBP",
        "symbol": "€",
        "name": "Euro",
        "minor_unit": 2
      },
      "items": [
        {
          "currency": {
            "code": "GBP",
            "symbol": "€",
            "name": "Euro",
            "minor_unit": 2
          }
        }
      ]
    },
    "refunds": [
      {
        "currency": {
          "code": "GBP",
          "symbol": "€",
          "name": "Euro",
          "minor_unit": 2
        },
        "payout_currency": {
          "code": "GBP",
          "symbol": "€",
          "name": "Euro",
          "minor_unit": 2
        },
        "payment_request": {
          "order_id": "ORD-2025-00123",
          "payment_token": "tok_abc123def456"
        },
        "merchant_webhook_deliveries": [
          {
            "event_type": "quidkey.payment_request.succeeded"
          }
        ],
        "fees": {
          "currency": {
            "code": "GBP",
            "symbol": "€",
            "name": "Euro",
            "minor_unit": 2
          },
          "items": [
            {
              "currency": {
                "code": "GBP",
                "symbol": "€",
                "name": "Euro",
                "minor_unit": 2
              }
            }
          ]
        }
      }
    ],
    "reversals": [
      {
        "currency": {
          "code": "GBP",
          "symbol": "€",
          "name": "Euro",
          "minor_unit": 2
        },
        "payout_currency": {
          "code": "GBP",
          "symbol": "€",
          "name": "Euro",
          "minor_unit": 2
        },
        "payment_request": {
          "order_id": "ORD-2025-00123",
          "payment_token": "tok_abc123def456"
        },
        "merchant_webhook_deliveries": [
          {
            "event_type": "quidkey.payment_request.succeeded"
          }
        ],
        "fees": {
          "currency": {
            "code": "GBP",
            "symbol": "€",
            "name": "Euro",
            "minor_unit": 2
          },
          "items": [
            {
              "currency": {
                "code": "GBP",
                "symbol": "€",
                "name": "Euro",
                "minor_unit": 2
              }
            }
          ]
        }
      }
    ]
  }
}