POST
/
cards
/
tokenized
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
   }
}

Elementos de captura de datos sensibles

Captura datos sensibles de manera segura y personalizada.

​
Headers

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

​
Body

​
token
string
required
Token de la tarjeta tokenizada.
​
holder_name
string
required
Nombre completo del titular como aparece en la tarjeta.
​
customer_id
string
required
Identificador único del 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
  }'