Detalle tarjeta

Endpoint para obtener los detalles de una tarjeta de crédito o débito registrada en OnePay.

GET /cards/{card_id}

Detalle tarjeta

cURL

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

200

{
  "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

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

JavaScript

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();

Python

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()

id · 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).

200

{
  "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"
}