Integrate Colombia Local Acquiring and have access to a consumer base of over 51 million. PPRO processes all major domestic and international card brands on local payment rails offering both local and international settlement options for wherever your business is located.

Payment method properties


Markets (consumer)	`CO`
Processing currencies	`COP`
Consumer currencies	`COP`
Minimum payment amount	0.00 COP
Maximum payment amount	Varies by card issuer
Payment instrument	`CARD_PPRO_VAULTED`
Network tokens	Yes
Recurring payments	Yes
Separate captures	Yes
Installments	No
Validation	Yes
Refund	Full - Partial - Multiple
Refund validity	180 days
Authorization reversal	Yes
Authorization validity	7 days
EMV 3-D Secure	No
Disputes	Yes
Settlement risk	No

Make a card payment

To create a one-time card payment, you'll need to provide the following data when calling our payment charges api:

Data Field	Description
`paymentMethod`	`CARD`
`amount.value`	The amount to be paid in the smallest units of the currency used.
`amount.currency`	`COP`
`consumer.name`	Full name of the consumer.
`consumer.country`	The country where the consumer is shopping.
`consumer.taxIdentification`	The consumer’s tax identification number. See the section Consumer Tax Identification for more details.
`instrument.type`	`RAW_CARD`
`instrument.details.brand` (optional)	`AMEX` `DINERS` `DISCOVER` `MASTER` `VISA` The `brand` field is optional. Only use one of the values listed above. If the card’s brand is not included in this list or is unknown, do not include the brand field.
`instrument.details.number`	The primary account number (PAN) of the card used for payment.
`instrument.details.cvv`	Card verification value (CVV) A security code used to verify that the card is in the consumer's possession and to authenticate the card during authorization.
`instrument.details.holderName`	The full name of the cardholder as it appears on the card.
`instrument.details.expiryMonth`	The one to two-digit expiration month of the card.
`instrument.details.expiryYear`	The four-digit expiration year of the card.

Request

POST /v1/payment-charges

{
	"paymentMethod": "CARD",
	"paymentDescriptor": "Acme Inc. - Order 123",
	"amount": {
		"value": 4500000,
		"currency": "COP"
	},
	"consumer": {
		"billingAddress": {},
		"country": "CO",
		"name": "John Smith",
		"taxIdentification": "1234567890"
	},
	"instrument": {
		"type": "RAW_CARD",
		"details": {
			"brand": "VISA",
			"number": "4111111111111111",
			"cvv": "123",
			"holderName": "John Smith",
			"expiryMonth": 1,
			"expiryYear": 2030
		}
	}
}

Response:

{
  "id": "charge_JqOxPe5C0ltzDym2Wb4zo",
  "paymentMethod": "CARD",
  "currency": "COP",
  "country": "CO",
  "paymentDescriptor": "Acme Inc. - Order 123",
  "status": "CAPTURE_PENDING",
  "consumer": {
    "name": "John Smith",
    "country": "CO",
		"taxIdentification": "1234567890",
    "billingAddress": {}
  },
  "authorizations": [
    {
      "id": "authz_GRlW0pINO5ftY8aLTVtbg",
      "amount": 4500000,
      "status": "AUTHORIZED",
      "createdAt": "2023-07-06T15:17:19.141Z",
      "updatedAt": "2023-07-06T15:17:19.141Z"
    }
  ],
  "captures": [],
  "refunds": [],
  "voids": [],
  "createdAt": "2023-07-06T15:17:19.043Z",
  "updatedAt": "2023-07-06T15:17:19.140Z",
  "_links": {
    "authorizations": {
      "href": "/v1/payment-charges/charge_JqOxPe5C0ltzDym2Wb4zo/authorizations"
    },
    "captures": {
      "href": "/v1/payment-charges/charge_JqOxPe5C0ltzDym2Wb4zo/captures"
    },
    "refunds": {
      "href": "/v1/payment-charges/charge_JqOxPe5C0ltzDym2Wb4zo/refunds"
    },
    "voids": {
      "href": "/v1/payment-charges/charge_JqOxPe5C0ltzDym2Wb4zo/voids"
    }
  }
}

Consumer Tax Identification

Requires customer ID: Cédula de Ciudadanía, Tarjeta de Identidad, Cédula de Extranjería, NIT or pasaporte.

Cédula de Ciudadanía: The Cédula de Ciudadanía (Citizenship Identification Card) is a number attributed by the National Civil Registry (Registraduría Nacional del Estado Civil) to all Colombian citizens aged 18 or older. In Colombia, this is the main identification document for citizens of legal age.
Tarjeta de Identidad: The Tarjeta de Identidad (Identity Card) is a number attributed by the National Civil Registry (Registraduría Nacional del Estado Civil) to all Colombian citizens aged 7 to 17. In Colombia, this is the main identification document for underage citizens.
Cédula de Extranjería: The Cédula de Extranjería (Foreigners Identification Card) is a number attributed by the Colombian Migration Agency (Migración Colombia) to all foreign citizens legally residing in Colombia. It is the main identification document for all foreign citizens.
NIT (Número de Identificación Tributaria – Tax Identification Number) is a number attributed by the DIAN (Dirección de Impuestos y Aduanas Nacionales – Direction of National Taxes and Customs) to all legal entities performing economical activities in Colombia deriving in revenue and, therefore, in its tax obligations before the local authorities.
Pasaporte: The Pasaporte (Passport), issued by the Colombian Ministry of Foreign Affairs, is the travel document used by Colombian citizens for the purpose of international identification.

Please collect any one of the five ID numbers above. Only digits that can go up to 10 with no punctuation.

The parameter where the information must be sent is:

customer.taxIdentification=1234567890

Handling the response

Once the payment has been successfully AUTHORIZED you can present the payment outcome to the consumer.
The payment charge status will be in CAPTURE_PENDING or CAPTURED depending if autoCapture was applied or not. If required, Capture the payment charge.