PSE

Rail overview

Use PSE for Colombian account-to-account pay-ins across participating banks.

The payer authorizes through their bank, the provider confirms the transaction, and Conomy applies the funds to the destination account.

Region Colombia

Currency COP

Direction Pay-in

Model Online bank transfer gateway

Use PSE for broad Colombian bank coverage and treat redirect completion separately from final settlement.

Required fields

Field	Type	Description
type	string	Must be "PSE"
currency	string	Must be "COP"
pse.bankId	string	Bank code selected by the user
pse.customer.firstName	string	Payer’s first name
pse.customer.lastName	string	Payer’s last name
pse.customer.documentNumber	string	Colombian ID number
pse.customer.documentType	string	Document type (e.g., "CC", "CE", "NIT")
pse.customer.phoneNumber	string	Payer’s phone number
pse.customer.email	string	Payer’s email

Example

{
  "type": "PSE",
  "currency": "COP",
  "pse": {
    "bankId": "1007",
    "customer": {
      "firstName": "Andrés",
      "lastName": "Martínez",
      "documentType": "CC",
      "documentNumber": "1020304050",
      "phoneNumber": "3001234567",
      "email": "andres@example.com"
    }
  }
}

Response fields

Field	Description
url	Bank redirect URL — send the user here
token	PSE session token

The bankId list can be retrieved from the financial institutions page.

Object

bankIdstringrequired

Bank identifier for PSE transfer.

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.