Bancolombia

Rail overview

Use BANCOLOMBIA for Colombian pay-ins where the payer authorizes through Bancolombia directly.

The payment remains provider-dependent until the bank confirms the transfer; Conomy then reconciles the amount and destination.

Region Colombia

Currency COP

Direction Pay-in

Model Direct bank button

Best for bank-native Colombian topups where the payer already expects a direct Bancolombia experience.

Required fields

Field	Type	Description
type	string	Must be "BANCOLOMBIA"
currency	string	Must be "COP"
bancolombia.customer.email	string	Payer’s email

Example

{
  "type": "BANCOLOMBIA",
  "currency": "COP",
  "bancolombia": {
    "customer": {
      "email": "usuario@example.com"
    }
  }
}

Response fields

Field	Description
url	Deep link / redirect URL to Bancolombia’s authorization flow

Redirect the user to bancolombia.url to complete authorization.

Object

customerobjectrequired

Information on who pays the transaction

idstring

Unique identifier for the internal service.

firstNamestringrequired

Payer's name

emailstring

Payer's email

lastNamestring

Payer's last name

phoneNumberstring

Payer's phone number without prefix

phoneNumberPrefixstring

Phone number prefix (e.g., +57)

documentTypestring

Documeny type of the entity (e.g., RUT, CURP, CURL). Go to the Supported Identity document types page for the complete list of supported values.

documentNumberstring

The document number associated with the documentType

addressobjectshow 8 properties

The entity’s address information.

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.