Bamboo provides multiple endpoints to retrieve purchase information, depending on the level of detail required.

Get Purchase

Use this endpoint to retrieve the original purchase object.
It returns the basic transaction info such as amount, status, and authorization code.

Get Purchase Details

Use this endpoint to access the complete transaction lifecycle,
including refunds, chargebacks, and other related events.

💡
These endpoints are helpful for reconciliation and troubleshooting. For real-time transaction updates, Bamboo recommends using webhooks.

Retrieve Original Purchase

The Get Purchase operation returns the original purchase data, including status, amount, and authorization info. It does not include refunds, chargebacks, or related transaction types.

Transaction ID

Use when you have the TransactionId from the purchase response or webhook.

Order ID

Use when you want to search using your own Order reference sent in the request.

Unique ID

Use when you use UniqueID for idempotency or internal tracking.

Request

Each endpoint requires your private key in the header for authorization. No request body is required.

Response Parameters

The response structure is identical to the standard Purchase response, ensuring consistency across different transaction types and simplifying integrations.

Parameter	Type	Description
`TransactionId`	`string`	Unique identifier for the transaction. A 19-digit number sent as a string for compatibility.
`Result`	`string`	Outcome of the transaction. Possible values: `COMPLETED` or `ACTION_REQUIRED`. See the Action object for instructions.
`Status`	`string`	Current status of the transaction (e.g., Approved, Rejected).
`ErrorCode`	`string`	Error code if the transaction was rejected.
`ErrorDescription`	`string`	Detailed description of the error if the transaction was rejected.
`Created`	`string`	Timestamp of when the transaction was created, in ISO 8601 format.
`AuthorizationDate`	`string`	Timestamp of when the transaction was authorized, in ISO 8601 format.
`AuthorizationCode`	`string`	Unique code provided by the issuer to confirm the transaction authorization.
`Amount`	`integer`	Total transaction amount.
`Currency`	`string`	Currency code used for the transaction. May differ from the request currency based on business agreements.
`Installments`	`integer`	Number of payment installments for the transaction.
`TaxableAmount`	`integer`	Amount subject to taxes.
`Tip`	`integer`	Tip amount, if applicable.
`Url`	`string`	Link to access additional transaction details.
`MetadataOut`	`object`	Additional metadata returned with the transaction response.
`Action`	`object`	Details of required actions when `Result` is `ACTION_REQUIRED`.
`PaymentMethod`	`object`	Information about the payment method used for the transaction.

Response Example

{
  "TransactionId": "79632697147789184",
  "Result": "COMPLETED",
  "Status": "APPROVED",
  "ErrorCode": null,
  "ErrorDescription": null,
  "Created": "2024-08-07T17:51:54.620",
  "AuthorizationDate": "2024-08-07T17:51:56.879",
  "AuthorizationCode": "839936",
  "Amount": 25000,
  "Currency": "BRL",
  "Installments": 2,
  "TaxableAmount": null,
  "Tip": null,
  "Url": "https://api.stage.bamboopayment.com/Purchase/79632697147789184",
  "MetadataOut": null,
  "Action": null,
  "PaymentMethod": {
    "Brand": "Visa",
    "CardOwner": "João Silva",
    "Bin": "450799",
    "IssuerBank": "Banco do Brasil",
    "Type": "CreditCard",
    "Expiration": "203008",
    "Last4": "4905"
  }
}

Full Purchase History

The Get Purchase Details operation retrieves the full lifecycle of a purchase, including the original purchase information, all related refunds, any chargeback associated with the transaction, etc.

📘
This endpoint is useful for auditing, troubleshooting, and post-settlement analysis. It is publicly available, but is not required for normal payment flow.

Endpoint

GET /Purchase/details/{transactionId}

The {transactionId} must refer to the original purchase. To retrieve a refund or chargeback directly, use GET /Transaction/{id} instead.

Response Fields

Field	Type	Description
`Purchase`	`object`	Original purchase object.
`Refunds`	`array`	List of refund transactions tied to the purchase.
`Chargeback`	`object`	Chargeback object, if present.
`Status`	`string`	Consolidated status based on the full transaction lifecycle.
`Currency`	`string`	Currency of the transaction.
`AuthorizationAmount`	`number`	Original authorized amount.
`CaptureAmount`	`number`	Total captured amount.
`RefundAmount`	`number`	Sum of all refunded amounts.
`TaxableAmount`	`number`	Taxable portion of the transaction.

Example Response

{
  "Purchase": {
    "TransactionId": "79632697147789184",
    "Result": "COMPLETED",
    "Status": "APPROVED",
    "AuthorizationDate": "2025-10-20T15:58:46.601Z",
    "AuthorizationCode": "839936",
    "Created": "2025-10-20T15:58:46.601Z",
    "Amount": 25000,
    "Currency": "COP",
    "Installments": 1,
    "Url": "https://api.stage.bamboopayment.com/Purchase/79632697147789184",
    "PaymentMethod": {
      "Brand": "Efecty",
      "Type": "PhysicalNetwork"
    }
  },
  "Refunds": [
    {
      "TransactionId": "79632697147789185",
      "Result": "COMPLETED",
      "Status": "APPROVED",
      "AuthorizationDate": "2025-10-22T13:20:01.601Z",
      "Amount": 25000,
      "Currency": "COP"
    }
  ],
  "Chargeback": null,
  "Status": "REFUNDED",
  "Currency": "COP",
  "AuthorizationAmount": 25000,
  "CaptureAmount": 25000,
  "RefundAmount": 25000,
  "TaxableAmount": 0
}

Discover the API

Choose the appropriate endpoint depending on the type of data you want to retrieve.

Get Purchase by ID

Use TransactionId to retrieve the original purchase object.

Get Purchase by Order

Use your own Order reference to fetch the purchase.

Get Purchase by Unique ID

Use your internal UniqueID to retrieve the original purchase.

Get Purchase Details

Returns the full lifecycle of a purchase, including refunds and chargebacks.

Get Transaction

Use this to fetch a transaction of any type (purchase, refund, or chargeback) by its ID.