Pse

PSE (Pago Seguro en Línea) is a local bank transfer payment method in Colombia that allows customers to pay directly from their bank accounts. UseePay plans to make PSE

│ available in early September 2026.

Overview

Property	Details
Markets (consumer)	`CO`
Consumer currencies	`COP`
Authentication methods	`REDIRECT`
Authentication timeout	7 days
Minimum payment amount	`1,600 COP`
Maximum payment amount	Subject to channel rules
Payment instrument	`BANK_TRANSFER`
Recurring payments	No
Separate captures	No
Refund	Yes
Refund validity	180 Days
Disputes	No

Payment Flow

Customer selects PSE at checkout.

Customer is redirected to the PSE payment page.

Customer selects their bank and completes payment authorization.

After payment is completed, the customer is returned to the merchant site.

The merchant receives the payment result from UseePay.

Notes

PSE is available for customers in Colombia.

The billing address country must be set to CO.

PSE supports one-time payments only. Recurring payments are not supported.

The customer name and identification number are required.

Provide either billing.name or both billing.first_name and billing.last_name.

payment_method_data.pse.identification_number must contain 6 to 11 digits.

The minimum payment amount is 1,600 COP.

Integration Guide

Create a PaymentIntent

Set payment_method_data.type to pse, set billing.address.country to CO, and provide the customer's name and identification number when creating the PaymentIntent.

**Request example **

You can provide the customer name as separate fields instead:

Response example — PSE (COP)

The following response is an illustrative example based on the PaymentIntent response model. IDs and URLs are placeholders; actual fields and values may vary by transaction.

{
    "id": "1012608270000000001",
    "code": "0000",
    "message": "Approved or completed successfully",
    "amount": 1600,
    "currency": "COP",
    "status": "requires_customer_action",
    "description": "Order payment",
    "confirm": true,
    "orderType": "sale",
    "mode": "payment",
    "sale": true,
    "merchant_no": "500000000000000",
    "app_id": "www.example.com",
    "create_at": "2026-08-27T10:00:00Z",
    "modify_at": "2026-08-27T10:00:00Z",
    "merchant_order_id": "your_order_id",
    "refunded_amount": 0,
    "next_action": {
        "type": "redirect",
        "redirect": {
            "method": "GET",
            "url": "https://payment-provider.example/redirect/example-token",
            "content_type": null,
            "app_url": null,
            "package_name": null
        }
    },
    "return_url": "https://your-site.com/payment/return",
    "client_secret": "example_client_secret",
    "auto_capture": true,
    "order_id": "1012608270000000001",
    "latest_payment_attempt": "pa_example0000001",
    "payment_attempt": {
        "id": "pa_example0000001",
        "billing": {
            "address": {
                "country": "CO"
            },
            "email": "juan.garcia@example.com",
            "name": "Juan Garcia"
        },
        "merchant_no": "500000000000000",
        "app_id": "www.example.com",
        "create_at": "2026-08-27T10:00:00Z",
        "modify_at": "2026-08-27T10:00:01Z",
        "api_version": null,
        "payment_intent_id": "1012608270000000001",
        "checkout_session_id": null,
        "merchant_order_id": "your_order_id",
        "order_id": "1012608270000000001",
        "payment_method_details": {
            "type": "pse"
        },
        "return_url": "https://your-site.com/payment/return"
    },
    "setup_future_usage": false
}

When status is requires_customer_action, redirect the customer to next_action.redirect.url using the specified HTTP method. After the customer completes or cancels the payment, they are returned to return_url.

Do not determine the final payment result only from the browser redirect. Retrieve the PaymentIntent or process the UseePay payment notification to obtain the latest transaction status.

Required Customer Information

Field	Requirement	Description
`billing.address.country`	Required	Must be `CO`.
`billing.name`	Conditionally required	Customer's full name. Required unless both `billing.first_name` and `billing.last_name` are provided.
`billing.first_name`	Conditionally required	Customer's first name. Use together with `billing.last_name` when `billing.name` is not provided.
`billing.last_name`	Conditionally required	Customer's last name. Use together with `billing.first_name` when `billing.name` is not provided.
`billing.email`	Required for Checkout	Customer's email address.
`payment_method_data.pse.identification_number`	Required	Colombian customer identification number, containing 6 to 11 digits.

Overview#

Payment Flow#

Notes#

Integration Guide#