---
title: "Purchase Preview"
method: POST
path: "/v3/api/purchase/preview"
tags: ["PurchaseV"]
---

# Purchase Preview

`POST /v3/api/purchase/preview`

Preview amounts, taxes, and exchange rate using raw card data through the secure endpoint. Exclusively for PCI-certified merchants.

## Request body

- PurchasePreviewCommand
  - `CardData` CardDataWeb
    - `CardHolderName` string, nullable
    - `Pan` string, nullable
    - `CVV` string, nullable
    - `Expiration` string, nullable
    - `Email` string, nullable
    - `Document` string, nullable
  - `TrxToken` string, nullable
  - `PaymentMethod` string, nullable
  - `Order` string, nullable
  - `InvoiceNumber` string, nullable
  - `UniqueID` string, nullable
  - `Installments` integer, nullable
  - `Amount` integer
  - `TaxableAmount` integer, nullable
  - `Tip` integer, nullable
  - `Currency` string, nullable
  - `TargetCountryISO` string, nullable
  - `Customer` PreviewCustomerData
    - `FirstName` string, nullable
    - `LastName` string, nullable
    - `DocumentNumber` string, nullable
    - `DocumentType` string, nullable
    - `PhoneNumber` string, nullable
    - `Email` string, nullable
    - `Address` PreviewAddressData
      - `Country` string, nullable
      - `City` string, nullable
      - `State` string, nullable
      - `PostalCode` string, nullable
      - `AddressDetail` string, nullable
  - `NetworkToken` PreviewNetworkTokenData
    - `Token` string, nullable
    - `Cryptogram` string, nullable
    - `Expiration_Month` integer
    - `Expiration_Year` integer
    - `CardHolderName` string, nullable
  - `CommerceKey` CommerceKeyDomain
    - `Key` string, nullable
  - `Language` string, nullable

## Response `200`

OK

- PreviewResponse
  - `ErrorCode` string, nullable
  - `ErrorDescription` string, nullable
  - `QuoteId` string, nullable
  - `CurrencyCode` string, nullable
  - `TotalAmount` number, double, nullable
  - `ExchangeRate` ExchangeRateResponse
    - `Value` number, double
    - `Code` string, nullable
  - `Charges` ChargeResponse[], nullable
    - `CurrencyCode` string, nullable
    - `AmountCategoryCode` string, nullable
    - `Amount` number, double
    - `Sign` string, nullable
    - `ResponsibleType` string, nullable
    - `ExchangeRate` ExchangeRateResponse
      - `Value` number, double
      - `Code` string, nullable
    - `Tax` TaxResponse
      - `Code` string, nullable
      - `Name` string, nullable
      - `Percentage` number, double

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/bamboopayment/apis/direct-purchase.md) · [All operations](https://skmtc.net/bamboopayment/apis/direct-purchase/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboopayment/direct-purchase/versions/10523581e6c2/schema)