Detalle tarjeta - OnePay Documentación

Detalle tarjeta

curl --request GET \
  --url https://api.onepay.la/v1/cards/{card_id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "9e01eeae-2868-4564-9d04-84d1d1d027d2",
  "brand": "Mastercard",
  "label": "Mastercard • 8099",
  "last_four": "8099",
  "expiration_date": "9/2026",
  "customer_id": "9df8018b-6a28-4696-b7b2-63615f34a2f5",
  "created_at": "2025-01-19T18:29:25.000000Z",
  "country": "CO"
}

GET

cards

{card_id}

Detalle tarjeta

curl --request GET \
  --url https://api.onepay.la/v1/cards/{card_id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "9e01eeae-2868-4564-9d04-84d1d1d027d2",
  "brand": "Mastercard",
  "label": "Mastercard • 8099",
  "last_four": "8099",
  "expiration_date": "9/2026",
  "customer_id": "9df8018b-6a28-4696-b7b2-63615f34a2f5",
  "created_at": "2025-01-19T18:29:25.000000Z",
  "country": "CO"
}

card_id

string

required

ID de la tarjeta tokenizada. Ver cómo registrar tarjetas.

curl
JavaScript
Python

curl https://api.onepay.la/v1/cards/bb02b2fd-154c-4c90-9fdf-cec3a0b25cf5 \
  -H "Authorization: Bearer sk_test_xxx"

const response = await fetch(
  'https://api.onepay.la/v1/cards/bb02b2fd-154c-4c90-9fdf-cec3a0b25cf5',
  {
    headers: {
      'Authorization': 'Bearer sk_test_xxx',
    },
  }
);
const card = await response.json();

import requests

response = requests.get(
    'https://api.onepay.la/v1/cards/bb02b2fd-154c-4c90-9fdf-cec3a0b25cf5',
    headers={'Authorization': 'Bearer sk_test_xxx'},
)
card = response.json()

string

Identificador único de la tarjeta (UUID).

brand

string

Marca de la tarjeta. Valores posibles: Visa, Mastercard, Amex, Diners.

label

string

Etiqueta de la tarjeta en formato Marca • últimos 4 dígitos.

last_four

string

Últimos 4 dígitos de la tarjeta.

expiration_date

string

Fecha de expiración en formato MM/YYYY.

customer_id

string

ID del cliente (guest) al que pertenece la tarjeta.

created_at

string

Fecha de creación en formato ISO 8601.

country

string

Código de país de emisión de la tarjeta (ISO 3166-1 alpha-2).

{
  "id": "9e01eeae-2868-4564-9d04-84d1d1d027d2",
  "brand": "Mastercard",
  "label": "Mastercard • 8099",
  "last_four": "8099",
  "expiration_date": "9/2026",
  "customer_id": "9df8018b-6a28-4696-b7b2-63615f34a2f5",
  "created_at": "2025-01-19T18:29:25.000000Z",
  "country": "CO"
}

Listar tarjetas

Crear tarjetas