Sign in
Payment.Settlement Accounts

Get refund

Retrieves a specific refund for a specific settlement account and merchant.

get/payment/v1/merchants/{merchantId}/accounts/{accountId}/refunds/{refundId}

Path parameters

merchantIdstring required

The id of the merchant.

accountIdstring required

The id of the account.

refundIdstring required

The id of the refund.

Response

A successful response.

accountIdstring required

Id of the settlement account. Output only.

createdTimestring date-time

The date and time when the refund was initiated. Output only.

idstring

Id of the refund. Output only.

merchantIdstring required

Id of the merchant. Output only.

metadataobject

A key-value dictionary with custom metadata for the refund. All keys and values must be strings. For privacy protection, it is not allowed to use this dictionary for storing personal data (e.g. names and addresses).

referencestring required

External reference set by the merchant, must be between 6-18 characters long.

scheme'SCHEME_UNSPECIFIED' | 'FASTER_PAYMENTS' | 'SEPA_INSTANT_CREDIT_TRANSFER' | 'SEPA_CREDIT_TRANSFER' | 'BACS' | 'CHAPS'

Payment scheme.

  • SCHEME_UNSPECIFIED: Default unspecified scheme.
  • FASTER_PAYMENTS: Faster payments scheme.
  • SEPA_INSTANT_CREDIT_TRANSFER: SEPA Instant Credit Transfer scheme.
  • SEPA_CREDIT_TRANSFER: SEPA Credit Transfer scheme.
  • BACS: BACS scheme.
  • CHAPS: CHAPS scheme.
status'PENDING' | 'COMPLETED' | 'FAILED'

Status of the refund.

  • PENDING: Default value.
  • COMPLETED: Refund was successful.
  • FAILED: Refund failed to complete.
transactionIdstring required

Id of the transaction to refund.

updatedTimestring date-time

The date and time when the refund was updated. Output only.

Example response

{
  "accountId": "161ec210-721f-4df5-b21c-f78a9d4c1545",
  "amount": {
    "currencyCode": "EUR",
    "value": {
      "scale": "2",
      "unscaledValue": "5000"
    }
  },
  "createdTime": "2022-07-14T14:01:53Z",
  "id": "b58d313a-b778-4639-8e31-c9ffc35e2d01",
  "merchantId": "e06e47f1-8c88-47ee-9415-a4cde72ae598",
  "metadata": {
    "key1": "value1",
    "key2": "value2"
  },
  "reference": "Refund7ad0feabb4ab",
  "scheme": "SEPA_INSTANT_CREDIT_TRANSFER",
  "status": "COMPLETED",
  "transactionId": "7ad0feab-bd55-449d-aa7e-b3d3b9c62550",
  "updatedTime": "2022-07-14T14:08:53Z"
}