Skip to main content
POST
/
v1
/
cards
curl --request POST \
  --url https://cards.onepay.la/v1/cards \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'x-idempotency: unique-id-1234' \
  --data '{
    "card_number": "4242424242424242",
    "expiration_year": "28",
    "expiration_month": "08",
    "ccv": "123",
    "holder_name": "Juan Pérez",
    "customer_id": "bb02b2fd-154c-4c90-9fdf-cec3a0b25cf5",
    "authorization": false
  }'

{
   "id":"9e01eeae-2868-4564-9d04-84d1d1d027d2",
   "brand":"Mastercard",
   "last_four":"8099",
   "card_name":"Juan Pérez",
   "expiration_date":"2026-09-30T00:00:00.000000Z",
   "customer_id":"9df8018b-6a28-4696-b7b2-63615f34a2f5",
   "created_at":"2025-01-19T18:29:25.000000Z",
   "type":"credit_card",
   "country":"CO",
   "cvc_check":true,
   "verified":true,
   "title":"Mastercard • 8099",
   "method_type":"credit_card",
   "action":{
      "action":"NULL",
      "next":null
   }
}
Cambio de dominio para el endpoint de tarjetas: https://cards.onepay.la/v1/cards
Este cambio se implementa mediante un proxy con el objetivo de mejorar la gestión de la política PCI DSS y garantizar un cumplimiento más seguro y eficiente de los estándares de seguridad en el manejo de datos de tarjetas.

​
Headers

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

​
Body

​
card_number
string
required
Número de la tarjeta de crédito o débito.
​
expiration_year
string
required
Año de vencimiento en formato de 2 dígitos (ejemplo: 28).
​
expiration_month
string
required
Mes de vencimiento en formato de 2 dígitos (ejemplo: 08).
​
ccv
string
required
Código de seguridad de la tarjeta.
​
holder_name
string
required
Nombre completo del titular como aparece en la tarjeta.
​
customer_id
string
required
ID del cliente dueño de la tarjeta. Crear cliente.
​
authorization
boolean
required
Indica si el usuario ha autorizado débitos automáticos para esta tarjeta.
{
   "id":"9e01eeae-2868-4564-9d04-84d1d1d027d2",
   "brand":"Mastercard",
   "last_four":"8099",
   "card_name":"Juan Pérez",
   "expiration_date":"2026-09-30T00:00:00.000000Z",
   "customer_id":"9df8018b-6a28-4696-b7b2-63615f34a2f5",
   "created_at":"2025-01-19T18:29:25.000000Z",
   "type":"credit_card",
   "country":"CO",
   "cvc_check":true,
   "verified":true,
   "title":"Mastercard • 8099",
   "method_type":"credit_card",
   "action":{
      "action":"NULL",
      "next":null
   }
}

curl --request POST \
  --url https://cards.onepay.la/v1/cards \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'x-idempotency: unique-id-1234' \
  --data '{
    "card_number": "4242424242424242",
    "expiration_year": "28",
    "expiration_month": "08",
    "ccv": "123",
    "holder_name": "Juan Pérez",
    "customer_id": "bb02b2fd-154c-4c90-9fdf-cec3a0b25cf5",
    "authorization": false
  }'