--- updatedAt: 2026-08-17T16:30:44.000Z agentTools: siteIndex: https://docs.affirm.com/llms.txt projectIndex: https://docs.affirm.com/developers/llms.txt --- # Read Transaction Retrieves transaction data. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Merchant Transaction API", "version": "1.0.0" }, "servers": [ { "url": "https://sandbox.affirm.com/api/v1" }, { "url": "https://api.affirm.com/api/v1" } ], "security": [ { "basicAuth": [] } ], "paths": { "/transactions/{transaction_id}": { "get": { "tags": [ "Transactions API" ], "summary": "Read Transaction", "description": "Retrieves transaction data.", "operationId": "read_transaction", "parameters": [ { "name": "transaction_id", "in": "path", "description": "A unique ID representing the transaction’s loan or charge ID. Displays as `id` in the response.", "required": true, "schema": { "type": "string", "example": "ABCD-1234" } }, { "name": "expand", "in": "query", "description": "A comma-separated set of related objects to expand in the response. Allowed values are 'checkout' and 'events'.", "required": false, "schema": { "type": "string" } }, { "name": "Has-Strict-Validation", "in": "header", "description": "Optional param to denote whether client-side strict validation is used. Defaults to True if no param provided.", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "HTTP 200 OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/Transaction3" } } } }, "400": { "description": "HTTP 400 Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorBadRequest" } } } }, "401": { "description": "HTTP 401 Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorUnauthorized" } } } }, "404": { "description": "HTTP 404 Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorNotFound" } } } } }, "x-swagger-router-controller": "affirm.http.api.merchant.transaction.v1.api" } } }, "components": { "schemas": { "ErrorBadRequest": { "type": "object", "properties": { "message": { "type": "string", "description": "The error message.", "example": "Bad Request" }, "status_code": { "type": "integer", "description": "The HTTP status code.", "example": 400 }, "type": { "type": "string", "description": "The error type.", "example": "BAD_REQUEST" }, "code": { "type": "string", "description": "The error type.", "example": "BAD_REQUEST" } } }, "ErrorNotFound": { "type": "object", "properties": { "message": { "type": "string", "description": "The error message.", "example": "Not Found" }, "status_code": { "type": "integer", "description": "The HTTP status code.", "example": 404 }, "type": { "type": "string", "description": "The error type.", "example": "NOT_FOUND" }, "code": { "type": "string", "description": "The error type.", "example": "NOT_FOUND" } } }, "ErrorUnauthorized": { "type": "object", "properties": { "message": { "type": "string", "description": "The error message.", "example": "Unauthorized" }, "status_code": { "type": "integer", "description": "The HTTP status code.", "example": 401 }, "type": { "type": "string", "description": "The error type.", "example": "UNAUTHORIZED" }, "code": { "type": "string", "description": "The error type.", "example": "UNAUTHORIZED" } } }, "Transaction3": { "type": "object", "properties": { "checkout_id": { "type": "string", "description": "A unique identifier representing the transaction’s checkout ID.", "example": "HTSZAGURU7PZ8ZAG" }, "provider_id": { "type": "integer", "description": "A unique identifier of the provider that is financing the transaction.", "example": 1 }, "remove_tax": { "type": "boolean", "description": "Indicates if tax was paid by the provider (Affirm, LTO). Used by platform integrations to remove tax.", "example": true }, "status": { "type": "string", "description": "The status of the transaction.", "example": "captured" }, "currency": { "type": "string", "description": "The local currency of the transaction with its being a valid subset of the ISO 4217 currency code.", "example": "USD" }, "created": { "type": "string", "description": "The time when the transaction was created. The value is formatted in RFC 3339.", "example": "2019-01-01T00:00:00.000Z" }, "authorization_expiration": { "type": "string", "description": "The time when the transaction can no longer be authorized. The value is formatted in RFC 3339.", "example": "2019-01-01T00:00:00.000Z" }, "amount_refunded": { "type": "integer", "description": "The amount refunded back to the customer from this transaction. The value may be less than the total amount financed if a partial refund was issued. The value is non-negative and is represented in the smallest currency unit, such as cents instead of dollars.", "example": 5000 }, "amount": { "type": "integer", "description": "The original amount financed to the customer in this transaction. The value is non-negative and is represented in the smallest currency unit, such as cents instead of dollars.", "example": 20000 }, "id": { "type": "string", "description": "A unique ID representing the transaction’s loan or charge ID.", "example": "ABCD-1234" }, "order_id": { "maxLength": 128, "minLength": 1, "type": "string", "description": "Identifies the order within the merchant's order management system that this transaction corresponds to.", "example": "order_125" }, "events": { "type": "array", "properties": {}, "description": "An array of TransactionEvent objects.", "x-nullable": true, "items": { "$ref": "#/components/schemas/TransactionEvent3" } } } }, "TransactionEvent3": { "type": "object", "properties": { "amount": { "type": "integer", "description": "The total value of the transaction event, including tax and shipping. The value is non-negative and is represented in the smallest currency unit, such as cents instead of dollars. If the type is capture, this field represents the amount captured. If the type is refund, this field represents the amount refunded, including the fee that was refunded.", "example": 20000 }, "id": { "type": "string", "description": "A unique identifier for the transaction event.", "example": "ABCD-1234" }, "currency": { "type": "string", "description": "The local currency of the transaction with its being a valid subset of the ISO 4217 currency code.", "example": "USD" }, "type": { "type": "string", "description": "The type of event, such as auth, auth_expired, capture, charge_off, confirm, confirmation_expired, expire_authorization, expire_confirmation, refund, split_capture, update, void, partial_void, and refund_voided.", "example": "auth" }, "created": { "type": "string", "description": "The time when the transaction event was created. The value is formatted in RFC 3339.", "example": "2019-01-01T00:00:00.000Z" } } } }, "securitySchemes": { "basicAuth": { "type": "http", "scheme": "basic" } } }, "x-readme": { "explorer-enabled": true, "proxy-enabled": true, "samples-enabled": true } } ``` # Sibling pages * [List Transactions](https://docs.affirm.com/developers/reference/list_transactions.md) * [Authorize Transaction](https://docs.affirm.com/developers/reference/authorize_transaction.md) * [List Transaction Events](https://docs.affirm.com/developers/reference/list_transaction_events.md) * [Update Transaction](https://docs.affirm.com/developers/reference/update_transaction.md) * [Capture Transaction](https://docs.affirm.com/developers/reference/capture_transaction.md) * [Refund Transaction](https://docs.affirm.com/developers/reference/refund_transaction.md) * [Void Transaction](https://docs.affirm.com/developers/reference/void_transaction.md) * [List Settlement Events](https://docs.affirm.com/developers/reference/list_settlement_events.md) * [List Settlement Event Summaries](https://docs.affirm.com/developers/reference/list_settlement_event_summaries.md)