Backend API

Fields
idobjectId

Unique identifier for the refund.

account_card_idobjectId

ID of the customer's credit card on file used to make the refund, if applicable.

amountcurrencyrequired

Refund amount denominated in currency.

asyncbooleanauto

Indicates the refund is processed asynchronously. The refund will be updated in the future while success is undefined.

cardobject

Credit card details used to make the refund, if applicable.

currencystring

Three-letter ISO currency code in uppercase. Defaults to the store's base currency.

currency_ratefloat

Currency percentage used in calculating the fixed refund amount.

date_async_updatedate

The date of the next time the payment status will be updated.

date_createddateauto

Date and time the refund was created.

date_updateddateauto

Date and time the refund was last updated.

errorobject

An object describing an error that occurred while interacting with the payment gateway, if applicable.

gatewaystring

ID of the payment gateway that was used to process the refund.

methodstringrequired

Method of refund. Can be card, account, amazon, paypal, or any one of the manual methods defined in payment settings. Defaults to the original payment method.

numberstringauto

Unique incremental refund number assigned automatically.

orderOrder

Expandable link to the order the refund was applied to, if applicable.

order_idobjectId

ID of the order the refund was applied to, if applicable.

parentPayment

Expandable link to the payment.

parent_idobjectIdrequired

ID of the payment the refund was issued for.

reasonstring

Reason for which the refund was issued.

reason_messagestring

A brief message describing the reason for the refund.

statusenumauto

Status of the refund. Can be pending, which is awaiting async processing, error, or success.

Possible enum values:

pendingvoiderrorsuccess
subscriptionSubscription

Expandable link to the subscription the refund was applied to, if applicable.

subscription_idobjectIdauto

ID of the subscription the refund was applied to, if applicable.

successboolean

Indicates the refund was successful. When an error occurs with a payment gateway, this value will be false and error field will be populated.

transaction_idstringauto

External identifier returned by a payment gateway, if applicable.

The refund model
{
  "id": "60f199509111e70000000042",
  "amount": 20,
  "method": "card",
  "parent_id": "60f199509111e70000000045",
  "async": false,
  "currency": "USD",
  "date_created": "2021-07-16T14:36:00.293Z",
  "date_updated": "2021-07-16T14:36:00.293Z",
  "error": null,
  "number": 102934,
  "order_id": "60f199509111e70000000044",
  "reason_message": "Customer returned EX2001",
  "status": "success",
  "success": true,
  "transaction_id": "re_1XNoXdEAeofUkt5SrbA6Swow"
}