Skip to main content
Nuvei is a global payment provider that provides comprehensive payment processing solutions across multiple payment methods and regions. PSE is a popular online payment method in Colombia that allows customers to pay directly from their bank account using the Colombian banking system. It is widely used for e-commerce transactions in Colombia.

Setup

Please follow the common Nuvei instructions to get set up with Nuvei. After setting up your Nuvei account, make sure PSE is enabled as a payment method on your account.

Capabilities

Supported countries

Supported currencies

Integration

For PSE, the default integration for Nuvei is through a redirect to a hosted payments page. The PSE connection via Nuvei requires a few fields in the transaction request:
  • buyer.billing_details.first_name and buyer.billing_details.last_name - Customer name
  • buyer.billing_details.email_address - Customer’s email
  • connection_options.nuvei-pse.userType - Customer type (“N” for personal, “J” for a legal entity)
  • connection_options.nuvei-pse.userFisNumber - Customer’s document type
  • connection_options.nuvei-pse.fiscalNumber - Customer’s document number
  • connection_options.nuvei-pse.bankCode - The bank code of the selected bank
Start by creating a new transaction with the required fields:
After the transaction is created, the API response includes payment_method.approval_url and the buyer_approval_pending status.
Redirect the buyer to the approval_url so they can complete authentication and approve the payment. After approval the buyer is redirected to the redirect_url you provided when creating the transaction. Do not rely solely on the redirect - either poll the transaction or (recommended) rely on webhooks to detect the final status (for example capture_succeeded or failure states).

Testing

It is recommended to use bankCode 1022 for testing. Nuvei has instructions on how to test PSE.