POST
/
connect-links
curl --request POST \
  --url https://api.onepay.la/v1/connect-links \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency: <x-idempotency>' \
  --data '{
  "customer_id": "<string>",
  "single_use": true,
  "notify": true,
  "allows": {
    "cards": true,
    "accounts": true,
    "card_extra": true,
    "realtime": true,
    "pse": true,
    "transfiya": true
  },
  "external_id": "<string>",
  "redirect_url": "<string>",
  "metadata": {}
}'
{
    "id": "9e92f61e-e90f-4fbb-a551-080fd4fb4f6f",
    "customer_id": "9957858a-c2f1-4f18-a5c2-216b4127e278",
    "single_use": false,
    "visits": 0,
    "completed": 0,
    "external_id": "31231231231",
    "allows": {
        "cards": true,
        "accounts": true,
        "card_extra": false,
        "realtime": false,
        "pse": true,
        "transfiya": true
    },
    "created_at": "2025-04-01T20:45:16.000000Z",
    "updated_at": "2025-04-01T20:45:16.000000Z",
    "url": "https://pagos.onepay.la/connect-link/9e92f61e-e90f-4fbb-a551-080fd4fb4f6f"
}

​
Headers

​
x-idempotency
string
required

Token único para garantizar la idempotencia de la petición

​
Body

​
customer_id
string
required

ID único del cliente que deseas consultar

​
single_use
boolean

Define si el enlace de conexión (Connect Link) será de un solo uso o de múltiples usos. Si se establece en true, el enlace será de un solo uso; si es false, permitirá múltiples conexiones.

​
notify
boolean

Indica si se debe notificar al cliente cuando se complete el pago

​
allows
object

Configuración de métodos de pago permitidos.

​
external_id
string

ID único del cliente en tu sistema

​
redirect_url
string

URL a la que se redirigirá al cliente después de completar el pago

​
metadata
object

Metadatos adicionales que deseas asociar con el link

​
Response

{
    "id": "9e92f61e-e90f-4fbb-a551-080fd4fb4f6f",
    "customer_id": "9957858a-c2f1-4f18-a5c2-216b4127e278",
    "single_use": false,
    "visits": 0,
    "completed": 0,
    "external_id": "31231231231",
    "allows": {
        "cards": true,
        "accounts": true,
        "card_extra": false,
        "realtime": false,
        "pse": true,
        "transfiya": true
    },
    "created_at": "2025-04-01T20:45:16.000000Z",
    "updated_at": "2025-04-01T20:45:16.000000Z",
    "url": "https://pagos.onepay.la/connect-link/9e92f61e-e90f-4fbb-a551-080fd4fb4f6f"
}

Was this page helpful?