PSE

Colombian online bank transfer gateway. Used for pay-in in Colombia.

PSE (Pagos Seguros en Línea) is Colombia's primary online bank transfer system. The user selects their bank and is redirected to complete the payment on the bank's page.

Country: Colombia | Currency: COP | Direction: Pay-in

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": "[email protected]"
    }
  }
}

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.

Schema

The pse object

Attributes

bankIdstringRequired

Bank identifier for PSE transfer.

successUrlstringOptional

Redirect URL on successful payment.

failedUrlstringOptional

Redirect URL on failed payment.

The pse object

{
  "bankId": "text",
  "customer": {
    "id": "text",
    "firstName": "text",
    "email": "text",
    "lastName": "text",
    "phoneNumber": "text",
    "phoneNumberPrefix": "text",
    "documentType": "text",
    "documentNumber": "text",
    "address": {
      "administrativeAreaLevel1": "text",
      "administrativeAreaLevel2": "text",
      "administrativeAreaLevel3": "text",
      "street": "text",
      "streetNumber": "text",
      "optionalAddress": "text",
      "country": "text",
      "zipcode": "text"
    }
  },
  "successUrl": "text",
  "failedUrl": "text"
}