Credit and Debit Cards

This page describes Colombia-specific requirements for the Create a Purchase operation. Refer to the create a Purchase guide for the full parameter list and base definitions.

Mandatory fields for Colombia

The following fields are required in addition to the global mandatory parameters.

Property	Type	Description
`Customer` → `FirstName`	`string`	Customer’s first name.
`Customer` → `LastName`	`string`	Customer’s last name.
`Customer` → `DocumentType`	`string`	Type of identification document. Use `CC.CO` for individuals or `NIT.CO` for companies.
`Customer` → `DocumentNumber`	`string`	Identification number corresponding to the selected document type.
`Customer` → `Address` → `State`	`string`	Department or province.
`Customer` → `Address` → `City`	`string`	City of residence.
`Customer` → `Address` → `AddressDetail`	`string`	Street number.
`Customer` → `Address` → `PostalCode`	`string`	Postal code.
`MetaDataIn` → `TaxAmount`	`numeric`	VAT amount of the purchase. Mandatory for domestic purchases. Use integer values without a decimal separator (e.g., `1225` for COP 12.25).

Conditionally required / recommended

Property	Type	Guidance
`SoftDescriptor`	`string`	Optional. Text shown on the cardholder’s bank statement (recommended format: `Bamboo*MerchantName`).
`Customer` → `PhoneNumber`	`string`	Optional. Include to improve anti-fraud scoring.
`Customer` → `Address` → `Country`	`string`	Optional. Cardholder Country

🔁
This payment methods use an API flow. The response to the purchase request will include the final status (COMPLETED, REJECTED, etc.), without redirection.

Request example using Token

To test this endpoint, use the API Reference or the Postman Collection

{
  "TrxToken": "OT__co_6dHAgJo6qeg62qIroA7H7_f_NWZZ6IEx4jiYpVJ8SzQ_",
  "UniqueID": "co-order-10001",
  "Capture": true,
  "TargetCountryISO": "CO",
  "Currency": "COP",
  "Amount": 25000,
  "Installments": 1,
  "Order": "CO-INV-10001",
  "Description": "Compra en línea - Pedido 10001",
  "Customer": {
    "FirstName": "Juan",
    "LastName": "Pérez",
    "ReferenceCode": "CLI-CO-0001",
    "PhoneNumber": "3204567890",
    "DocumentNumber": "1012345678",
    "DocumentType": "CC.CO",
    "Email": "[email protected]",
    "Address": {
      "Country": "CO",
      "City": "Bogota D.C",
      "State": "Bogota D.C",
      "PostalCode": "110111",
      "AddressDetail": "Calle 100 #10-20 Oficina 302"
    }
  },
  "MetaDataIn": {
    "TaxAmount": 4000
  },
  "CustomerIP": "190.10.224.231",
  "AntifraudData": {
    "AntifraudFingerprintId": "0046f17b-197a-4d63-8b6b-6082cdd557ff"
  }
}

Request example using Card Data

To test this endpoint, use the API Reference or the Postman Collection

{
  "CardData": {
    "CardHolderName": "Juan Pérez",
    "Pan": "5303710409428783",
    "CVV": "355",
    "Expiration": "05/26",
    "Email": "[email protected]",
    "Document": "1012345678"
  },
  "UniqueID": "co-order-10002",
  "Capture": true,
  "TargetCountryISO": "CO",
  "Currency": "COP",
  "Amount": 25000,
  "Installments": 1,
  "Order": "CO-INV-10002",
  "Description": "Compra en línea - Prueba tarjeta",
  "Customer": {
    "FirstName": "Juan",
    "LastName": "Pérez",
    "ReferenceCode": "CLI-CO-0002",
    "PhoneNumber": "3204567890",
    "DocumentNumber": "1012345678",
    "DocumentType": "CC.CO",
    "Email": "[email protected]",
    "Address": {
      "Country": "CO",
      "City": "Bogota D.C",
      "State": "Bogota D.C",
      "PostalCode": "110111",
      "AddressDetail": "Carrera 7 #72-35 Piso 4"
    }
  },
  "MetaDataIn": {
    "TaxAmount": 4000
  },
  "CustomerIP": "190.10.224.231",
  "AntifraudData": {
    "AntifraudFingerprintId": "0046f17b-197a-4d63-8b6b-6082cdd557ff"
  }
}

Response parameters

For more information on the response parameters, please refer to the Response parameters section of the Purchase creation.

Review Create Purchase Guide

Check the global request and response rules before building your request.

Try it in API Reference

Test the endpoint directly and explore real request/response examples.

Testing cards

Use the following cards to simulate different statuses of the purchase in the staging environment.

For approved purchases

Brand	PAN	CVV	Expiration
Mastercard	`5303710409428783`	355	`05/26`
Visa	`4513076106055348`	159	`06/26`
Diners	`36032429319768`	9052	`12/26`

For rejected / special cases

Scenario	PAN	CVV	Expiration
Insufficient funds (Mastercard)	`5529030604551745`	124	`11/26`

Discover the API

Once you’re familiar with how to create a purchase, you can test your integration using our API Reference:

Country Requirements

Check what each country requires in terms of documents, bank formats, and supported currencies.

Create a Payment

Explore full request and response examples.

Error Codes

Understand possible error responses and how to resolve them.