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 or retrieve API call to the /api/refunds endpoint.
Fields
Field
Type
Description
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.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
meta.mode
string
The resource environment (can be one of test or live)

Field	Type	Description
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.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
meta.mode	`string`	The resource environment (can be one of `test` or `live`)

Refunds

List all refunds

Last modified 1mo ago