Sign in

v1

latestOpenAPI 3.0.32026-07-264469137.7 KB
Refunds

Retrieve a refund by charge

Retrieve the refund associated with a specific payment by payment_id.

get/v1/refunds/by-charge/{payment_id}

Path parameters

payment_idstring required

The ID of the payment whose refund you want to retrieve.

Response

Success - Refund retrieved for charge

refund_idstring

Unique identifier for this refund.

charge_idstring

The payment this refund is associated with.

referencestring

The reference you supplied on creation.

status'processing' | 'success' | 'failed'

Current refund status. processing = awaiting provider (1-5 business days); success = funds returned to customer; failed = refund rejected.

requested_amountstring

The refund amount you requested, in the charge's settlement currency.

refunded_amountstring nullable

The amount actually returned to the customer. Null until the refund completes or partially settles.

refund_fee_amountstring

Fee charged for this refund, in the charge's settlement currency. "0" if no fee applies.

fee_bearer'org' | 'customer'

Who bears the refund processing fee. org means the merchant absorbs the fee; customer means it is deducted from the refunded amount.

reasonstring nullable

The reason you provided, or null if none was given.

created_atstring date-time

ISO 8601 timestamp when the refund was created.

updated_atstring date-time

ISO 8601 timestamp of the last status update.

completed_atstring date-time nullable

ISO 8601 timestamp when the refund reached a terminal status (SUCCESS or FAILED). Null while still processing.

Example response

{
  "refund_id": "ref_1a2b3c4d5e",
  "charge_id": "chr_1a2b3c4d5e6f",
  "reference": "refund_9876",
  "status": "processing",
  "requested_amount": "29.00",
  "refund_fee_amount": "0.00",
  "fee_bearer": "merchant",
  "reason": "Customer requested cancellation",
  "created_at": "2026-04-27T12:00:00Z",
  "updated_at": "2026-04-27T12:00:00Z"
}