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

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
  }'

Was this page helpful?