Cash Payments

Cash payments in Colombia allow customers to complete their purchases in cash through a nationwide network of authorized retail locations.

When selecting this payment method, Bamboo generates a voucher containing the payment details (amount, reference code, and expiration date). The customer presents the voucher and pays the specified amount in cash at any supported payment point. Once the payment is processed by the network, Bamboo automatically updates the transaction status via its asynchronous notification system.

↩️
Redirect Flow for Cash
This payment method uses a Redirect flow. The API response includes an Action and the purchase remains in Pending status until the customer completes the payment in a Payment office.

Request Parameters

The following parameters are required specifically for this payment method.
Refer to the Purchase operation guide for standard fields and authentication requirements.

Property	Type	Description
`PaymentMethod`	`string`	Must be one of the available cash payment codes (e.g. `EFC`, `APC`, `GNC`, etc.). Find the value in the Payment Methods section for Colombia.
`TargetCountryISO`	`string`	Destination country. Must be `CO`.
`Customer → Email`	`string`	Payer’s email.
`Customer → DocumentNumber`	`string`	Payer’s document number.

Recommended Fields

Property	Type	Description
`Customer → FirstName`	`string`	Payer’s first name.
`Customer → LastName`	`string`	Payer’s last name.
`Customer → DocumentType`	`string`	Use values like `CC.CO` for Colombian IDs. Refer to the Document types table to see the possible values.
`Customer → PhoneNumber`	`string`	Mobile or landline.
`Customer → Address → Country`	`string`	Payer’s country.
`Customer → Address → State`	`string`	Department or state.
`Customer → Address → City`	`string`	City of residence.
`Customer → Address → AddressDetail`	`string`	Full street address.
`Customer → Address → PostalCode`	`string`	ZIP or postal code.
`MetaDataIn → PaymentExpirationInMinutes`	`number`	Time (in minutes) before the payment expires.

ℹ️
Colombian Pesos (COP) does not support decimal values. Amounts must be multiplied by 100 (e.g., 5,000 COP → 500000).

Example Request

{
  "PaymentMethod": "EFC",
  "Order": "CO-CASH-0001",
  "Amount": 500000,
  "Currency": "COP",
  "Description": "Compra en efectivo - prueba",
  "TargetCountryISO": "CO",
  "Customer": {
    "FirstName": "Carlos",
    "LastName": "Ramírez",
    "Email": "[email protected]",
    "DocumentType": "CC.CO",
    "DocumentNumber": "1020304050",
    "PhoneNumber": "3001234567",
    "ReferenceCode": "CO-REF-001"
  },
  "MetaDataIn": {
    "PaymentExpirationInMinutes": 7200
  }
}

Response Parameters

The API returns the purchase with status PENDING and includes a voucher URL and metadata required to complete the payment at a physical location. For more information on the response parameters, please refer to the Response parameters section of the Purchase creation.

Property	Type	Description
`Action` → `URL`	`string`	URL of the payment voucher to be presented by the payer at the physical network.
`MetadataOut` → `PaymentCode`	`string`	Numeric code identifying the transaction to be paid.
`MetadataOut` → `PaymentExpirationDate`	`string`	Expiration date of the voucher. Format: `DD/MM/YYYY`.
`MetadataOut` → `AgreementCode`	`string`	Identifier for the agreement between Bamboo and the physical payment network.

Response Example

The payer must be redirected to the URL provided in Response → Action → URL, where the payment voucher can be viewed or printed. The payment must be completed in cash at any of the supported physical networks in Colombia.

{
  "TransactionId": "79632697147789184",
  "Result": "ACTION_REQUIRED",
  "Status": "PENDING",
  "ErrorCode": null,
  "ErrorDescription": null,
  "Created": "2024-08-07T17:51:54.620",
  "AuthorizationDate": null,
  "AuthorizationCode": null,
  "Amount": 500000,
  "Currency": "COP",
  "Url": "https://api.stage.bamboopayment.com/Purchase/79632697147789184",
  "MetadataOut": {
    "PaymentCode": "6273036",
    "PaymentExpirationDate": "22/08/2024",
    "AgreementCode": "110342"
  },
  "Action": {
    "URL": "https://s3.amazonaws.com/gateway.stage.bamboopayment.com/purchase-coupons/1131277_691e4de3-6eda-43ce-a01d-a6ea539d70fe_20240822.html",
    "Reason": "REDIRECTION_NEEDED_EXTERNAL_SERVICE"
  },
  "PaymentMethod": {
    "Brand": "Efecty",
    "Type": "PhysicalNetwork"
  }
}

Available Payment Networks

The following networks are available for cash payments.

Logo	PaymentMethod	Description
	`APC`	Apostar
	`BCC`	Bancolombia
	`EFC`	Efecty
	`GNC`	Gana
	`PNC`	Puntored
	`SPC`	Superpagos
	`SRC`	SuRed
	`SSC`	SuSuerte

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.