Skip to main content
POST
/
v1
/
cards
curl https://cards.onepay.la/v1/cards \
  -X POST \
  -H "Authorization: Bearer pk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: card-001" \
  -d '{
    "card_number": "4242424242424242",
    "expiration_year": "28",
    "expiration_month": "12",
    "ccv": "123",
    "holder_name": "JUAN PEREZ",
    "customer_id": "9dd4158b-0e45-42bc-b56f-a4c1f856814d",
    "authorization": true,
    "authentication": {
      "cavv": "AAABBEg0VhI0VniQEjRWAAAAAAA=",
      "eci": "05",
      "ds_trans_id": "f25084f0-5b16-4c0a-ae5d-b24808571000",
      "version": "2.2.0",
      "status": "Y"
    }
  }'

{
   "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.
​
authentication
object
Datos de autenticación 3D Secure. Envía este campo si realizaste la autenticación 3DS de forma externa.
{
   "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 https://cards.onepay.la/v1/cards \
  -X POST \
  -H "Authorization: Bearer pk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: card-001" \
  -d '{
    "card_number": "4242424242424242",
    "expiration_year": "28",
    "expiration_month": "12",
    "ccv": "123",
    "holder_name": "JUAN PEREZ",
    "customer_id": "9dd4158b-0e45-42bc-b56f-a4c1f856814d",
    "authorization": true,
    "authentication": {
      "cavv": "AAABBEg0VhI0VniQEjRWAAAAAAA=",
      "eci": "05",
      "ds_trans_id": "f25084f0-5b16-4c0a-ae5d-b24808571000",
      "version": "2.2.0",
      "status": "Y"
    }
  }'