braintree · Schema
Braintree Transaction
Represents a payment transaction processed through the Braintree gateway. A transaction captures the full lifecycle from authorization through settlement, refund, or void, and supports credit and debit cards, PayPal, Apple Pay, Google Pay, Venmo, ACH, and SEPA payment methods.
Properties
| Name | Type | Description |
|---|---|---|
| id | string | Unique identifier for the transaction assigned by Braintree. |
| amount | string | The transaction amount as a decimal string in the transaction currency. |
| status | string | The current processing status of the transaction. |
| type | string | The type of transaction. 'sale' represents a charge and 'credit' represents a refund. |
| currency_iso_code | string | ISO 4217 three-letter currency code for the transaction. |
| order_id | string | Merchant-provided order identifier associated with this transaction for reconciliation. |
| merchant_account_id | string | Identifier of the Braintree merchant account used to process this transaction. |
| customer_id | string | Identifier of the customer in the Braintree Vault associated with this transaction, if applicable. |
| payment_method_token | string | Token of the vaulted payment method used for this transaction, if applicable. |
| payment_method_nonce | string | The one-time payment method nonce used for this transaction, if applicable. |
| processor_response_code | string | The processor-specific response code returned when the transaction was processed. |
| processor_response_text | string | Human-readable text description of the processor response code. |
| gateway_rejection_reason | string | The reason the Braintree gateway rejected the transaction, if applicable. |
| tax_amount | string | The tax amount included in the transaction total, as a decimal string. |
| shipping_amount | string | The shipping amount included in the transaction total, as a decimal string. |
| transaction_source | string | Indicates the origin of the transaction for network reporting requirements. |
| billing | object | Billing address associated with this transaction. |
| shipping | object | Shipping address associated with this transaction. |
| customer_details | object | Summary of the customer associated with this transaction. |
| credit_card_details | object | Masked credit or debit card details used in this transaction. |
| descriptor | object | Dynamic descriptor fields that appear on the customer's bank statement. |
| refund_ids | array | List of transaction identifiers for refund transactions created against this transaction. |
| refunded_transaction_id | string | For refund transactions, the identifier of the original transaction being refunded. |
| subscription_id | string | Identifier of the subscription that generated this transaction, if applicable. |
| line_items | array | Line items for Level 3 processing data, up to 249 items. |
| disbursement_details | object | Disbursement information for when the transaction funds were or will be sent to the merchant. |
| created_at | string | Timestamp when the transaction was created, in ISO 8601 format. |
| updated_at | string | Timestamp when the transaction was last updated, in ISO 8601 format. |