The authorization object

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

An authorization object is returned as part of the response body of each successful list, retrieve or update API call to the /api/authorizations endpoint.

Fields

Field	Type	Description
type	string	authorizations
id	string	The authorization unique identifier
links.self	string	The authorization endpoint URL
attributes._capture	boolean	Send this attribute if you want to create a capture for this authorization.
attributes._capture_amount_cents	integer	Send this attribute as a value in cents if you want to overwrite the amount to be captured.
attributes._forward	boolean	Send this attribute if you want to forward a stuck transaction to succeeded and update associated order states accordingly.
attributes._void	boolean	Send this attribute if you want to create a void for this authorization.
attributes.amount_cents	integer	The transaction amount, in cents.
attributes.amount_float	float	The transaction amount, float.
attributes.avs_code	string	The AVS code returned by the payment gateway.
attributes.avs_message	string	The AVS message returned by the payment gateway.
attributes.capture_amount_cents	integer	The amount to be captured, in cents.
attributes.capture_amount_float	float	The amount to be captured, float.
attributes.capture_balance_cents	integer	The balance to be captured, in cents.
attributes.capture_balance_float	float	The balance to be captured, float.
attributes.created_at	datetime	Time at which the resource was created.
attributes.currency_code	string	The international 3-letter currency code as defined by the ISO 4217 standard, inherited from the associated order.
attributes.cvv_code	string	The CVV code returned by the payment gateway.
attributes.cvv_message	string	The CVV 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.formatted_amount	string	The transaction amount, formatted.
attributes.formatted_capture_amount	string	The amount to be captured, formatted.
attributes.formatted_capture_balance	string	The balance to be captured, formatted.
attributes.formatted_void_balance	string	The balance to be voided, formatted.
attributes.fraud_review	string	The fraud review message, if any, returned by the payment gateway.
attributes.gateway_transaction_id	string	The ID identifying the transaction, returned by the payment gateway.
attributes.message	string	The message returned by the payment gateway.
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.
attributes.number	string	The transaction number, auto generated.
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.succeeded	boolean	Indicates if the transaction is successful.
attributes.token	string	The token identifying the transaction, returned by the payment gateway.
attributes.updated_at	datetime	Time at which the resource was last updated.
attributes.void_balance_cents	integer	The balance to be voided, in cents.
attributes.void_balance_float	float	The balance to be voided, float.
relationships.attachments	array	The associated attachments.
relationships.captures	array	The associated captures.
relationships.events	array	The associated events.
relationships.order	object	The associated order.
relationships.versions	array	The associated changes.
relationships.voids	array	The associated voids.
meta.mode	string	The resource environment (can be one of test or live)