Skip to main content
POST
charges
/
pse
Crear un link de pago (PSE)
curl --request POST \
  --url https://api.onepay.la/v1/charges/pse \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency: <x-idempotency>' \
  --data '
{
  "customer_id": "<string>",
  "amount": 123,
  "bank_id": "<string>",
  "external_id": "<string>",
  "redirect_url": "<string>"
}
'
{
  "id": "9e184fda-62bb-477b-9020-fa59f44f2b99",
  "url": "https://s.onepay.la/short/lxNKQp2je8"
}

​
Headers

​
x-idempotency
string
required
Token único para garantizar la idempotencia de la petición

​
Body

​
customer_id
string
required
ID del cliente al que se enviará el link. Crear cliente.
​
amount
number
required
Monto que vas a cobrar
​
bank_id
string
required
Identificador único del banco.
​
external_id
string
Identificador único del pago.
​
redirect_url
string
URL de retorno.
Protección automática contra duplicados. Si envías la misma combinación de customer_id, bank_id y amount dentro de los 2 minutos siguientes a un pago PSE anterior, recibirás HTTP 429 con el previous_payment_id del pago en curso para que puedas reusar ese flujo. Variar external_id, redirect_url o reference no esquiva la protección — los reintentos sobre la misma operación seguirán bloqueados.
{
  "id": "9e184fda-62bb-477b-9020-fa59f44f2b99",
  "url": "https://s.onepay.la/short/lxNKQp2je8"
}