🇨🇴 Colombia Local Acquiring

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


Category	Card
Markets	`CO`
Brands	`AMEX`, `CARNET`, `DINERS`, `DISCOVER`, `MASTER`, `VISA`
One-time payments	Yes
Recurring payments	Yes
Instalments	No
Zero value authorizations	Yes
Processing currencies	`COP`
Consumer currencies	`COP`
Settlement currencies	`COP`, `EUR`, `GBP`, `HKD`, `SGD`, `USD`
Minimum payment amount	0.00 COP
Maximum payment amount	Varies by card issuers
Refund	- Full - Partial - Multiple Partial
Captures	- Auto - Full - Partial
Refund validity	180 days
Authorization reversal	Yes
Authorization validity	7 days
EMV 3-D Secure	No
Chargeback	Yes
Authorization flow	Synchronous
Sandbox Availability	PPRO provided

One-time Payment

1. Create a payment charge

In your /v1/payment-charges request, include:

paymentMethod: CARD

instrument.type: RAW_CARD

Request:

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

Response:

{
  "id": "charge_JqOxPe5C0ltzDym2Wb4zo",
  "paymentMethod": "CARD",
  "currency": "COP",
  "country": "CO",
  "paymentDescriptor": "Acme Inc. - Order 123",
  "status": "CAPTURE_PENDING",
  "consumer": {
    "name": "John Smith",
    "country": "CO",
    "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"
    }
  }
}

2. Handle 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.