Método de pago
Un PaymentMethod representa una tarjeta tokenizada sobre tu propia cuenta de Wompi — Rekurra nunca ve ni almacena el número de tarjeta (PAN) ni el CVV.
Campos
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único |
customer_id | string | Cliente dueño del método de pago |
type | string | Actualmente solo CARD |
brand | string | Marca de la tarjeta (VISA, MASTERCARD, …) |
last4 | string | Últimos 4 dígitos |
exp_month / exp_year | integer | Vencimiento |
is_default | boolean | Si es el método por defecto del cliente |
state | string | pending · available · verification_pending |
created_at | datetime | Fecha de creación |
Cómo se tokeniza
- Tu frontend llama a
GET /v1/payment-methods/setuppara obtener la llave pública de Wompi de tu cuenta, los acceptance tokens y la URL de tokenización. - El frontend tokeniza la tarjeta directamente contra Wompi usando esa llave pública — el número de tarjeta nunca pasa por los servidores de Rekurra.
- Con el
tokenresultante, llamas aPOST /v1/payment-methodspara crear elPaymentMethod. Rekurra ejecuta una verificación (micro-cobro + void) sobre tu cuenta de Wompi.
Si Wompi requiere autenticación 3DS, la respuesta es 202 y el método de
pago queda en estado verification_pending hasta que el flujo de 3DS
concluya.
Ver la referencia completa en API → Payment methods y el flujo simplificado en Checkout hospedado, que hace todo esto por ti en una sola página.