---
title: "Create a Purchase"
method: POST
path: "/v3/api/Purchase"
tags: ["Purchase"]
---

# Create a Purchase

`POST /v3/api/Purchase`

Create a purchase using a token, without the merchant handling raw card data. Standard endpoint for non-PCI merchants.

## Request body

- AuthorizationCommand
  - `TrxToken` string, nullable
  - `PaymentMethod` string, nullable
  - `Order` string, nullable
  - `InvoiceNumber` string, nullable
  - `Description` string, nullable
  - `UniqueID` string, nullable
  - `AdditionalData` string, nullable
  - `Currency` string, nullable
  - `TargetCountryISO` string, nullable
  - `SoftDescriptor` string, nullable
  - `Capture` boolean
  - `HasCvv` boolean
  - `Installments` integer, nullable
  - `Amount` integer
  - `TaxableAmount` integer, nullable
  - `Tip` integer, nullable
  - `CardOnFile` CardOnFileData
    - `TransactionType` string, nullable
    - `Usage` string, nullable
    - `Reason` string, nullable
    - `NetworkTransactionId` string, nullable
  - `MetadataIn` object, nullable
  - `Redirection` UrlsRedirectionTransaction
    - `Url_Approved` string, nullable
    - `Url_Rejected` string, nullable
    - `Url_Canceled` string, nullable
    - `Url_Pending` string, nullable
  - `AntifraudData` FraudPreventData
    - `AntifraudFingerprintId` string, nullable
    - `AntifraudMetadataIn` object, nullable
    - `UserAgent` string, nullable
    - `ClientIP` string, nullable
  - `MerchantNotification` MerchantNotificationData
    - `url_Webhook` string, nullable
  - `Customer` CustomerData
    - `FirstName` string, nullable
    - `LastName` string, nullable
    - `ReferenceCode` string, nullable
    - `DocumentNumber` string, nullable
    - `DocumentType` string, nullable
    - `PhoneNumber` string, nullable
    - `Email` string, nullable
    - `BirthPlace` string, nullable
    - `BirthDate` string, date-time, nullable
    - `IsFinalConsumer` boolean
    - `Address` AddressData
      - `Country` string, nullable
      - `City` string, nullable
      - `State` string, nullable
      - `PostalCode` string, nullable
      - `AddressDetail` string, nullable
  - `LoyaltyPlan` LoyaltyPlanData
    - `LoyaltyPlanId` integer
    - `Points` integer
    - `BranchId` integer
    - `LoyaltyPlanUserIdentification` string, nullable
  - `ThreeDSAuthMethod` 'DISABLE' | 'EXTERNAL' | 'INTERNAL'
  - `ThreeDS` ThreeDSData
    - `Eci` string, nullable
    - `Xid` string, nullable
    - `Cavv` string, nullable
    - `Version` string, nullable
    - `TransactionId` string, nullable
    - `ThreeDSId` string, nullable
  - `NetworkToken` NetworkTokenData
    - `Token` string, nullable
    - `Cryptogram` string, nullable
    - `Expiration_Month` integer
    - `Expiration_Year` integer
    - `CardHolderName` string, nullable
  - `QuoteId` string, nullable

## Response `200`

Success

- PurchaseResponse
  - `ErrorCode` string, nullable
  - `ErrorDescription` string, nullable
  - `TransactionId` string, nullable
  - `Result` string, nullable
  - `Status` string, nullable
  - `AuthorizationDate` string, date-time, nullable
  - `AuthorizationCode` string, nullable
  - `MetadataOut` object, nullable
  - `Created` string, date-time
  - `Amount` integer
  - `Currency` string, nullable
  - `Installments` integer
  - `TaxableAmount` integer, nullable
  - `Tip` integer, nullable
  - `Url` string, nullable
  - `Action` CommerceActionReturn
    - `SessionId` string, nullable
    - `URL` string, nullable
    - `Reason` string, nullable
  - `PaymentMethod` PaymentMethodReturn
    - `Brand` string, nullable
    - `CardOwner` string, nullable
    - `Bin` string, nullable
    - `IssuerBank` string, nullable
    - `Type` string, nullable
    - `Expiration` string, nullable
    - `Last4` string, nullable
  - `CardOnFile` CardOnFileReturn
    - `NetworkTransactionId` string, nullable

## Other responses

- `400` — Bad Request
- `409` — Conflict

---

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