The refund object

A comprehensive list of the refund resource's attributes and relationships

A refund object is returned as part of the response body of each successful list, retrieve or update API call to the /api/refunds endpoint.

Fields

FieldTypeDescription

type

string

refunds

id

string

The refund unique identifier

links.self

string

The refund endpoint URL

attributes.number

string

The transaction number, auto generated.

attributes.currency_code

string

The international 3-letter currency code as defined by the ISO 4217 standard, inherited from the associated order.

attributes.amount_cents

integer

The transaction amount, in cents.

attributes.amount_float

float

The transaction amount, float.

attributes.formatted_amount

string

The transaction amount, formatted.

attributes.succeeded

boolean

Indicates if the transaction is successful.

attributes.message

string

The message returned by the payment gateway.

attributes.error_code

string

The error code, if any, returned by the payment gateway.

attributes.error_detail

string

The error detail, if any, returned by the payment gateway.

attributes.token

string

The token identifying the transaction, returned by the payment gateway.

attributes.gateway_transaction_id

string

The ID identifying the transaction, returned by the payment gateway.

attributes._forward

boolean

Send this attribute if you want to forward a stuck transaction to succeeded and update associated order states accordingly.

attributes.created_at

datetime

Time at which the resource was created.

attributes.updated_at

datetime

Time at which the resource was last updated.

attributes.reference

string

A string that you can use to add any external identifier to the resource. This can be useful for integrating the resource to an external system, like an ERP, a marketing tool, a CRM, or whatever.

attributes.reference_origin

string

Any identifier of the third party system that defines the reference code.

attributes.metadata

object

Set of key-value pairs that you can attach to the resource. This can be useful for storing additional information about the resource in a structured format.

relationships.order

object

The associated order.

relationships.attachments

array

The associated attachments.

relationships.events

array

The associated events.

relationships.versions

array

The associated changes.

relationships.reference_capture

object

The associated reference capture.

relationships.return

object

The associated return.

meta.mode

string

The resource environment (can be one of test or live)

Last updated