ConceptosMétodo de pago

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

CampoTipoDescripción
idstringIdentificador único
customer_idstringCliente dueño del método de pago
typestringActualmente solo CARD
brandstringMarca de la tarjeta (VISA, MASTERCARD, …)
last4stringÚltimos 4 dígitos
exp_month / exp_yearintegerVencimiento
is_defaultbooleanSi es el método por defecto del cliente
statestringpending · available · verification_pending
created_atdatetimeFecha de creación

Cómo se tokeniza

  1. Tu frontend llama a GET /v1/payment-methods/setup para obtener la llave pública de Wompi de tu cuenta, los acceptance tokens y la URL de tokenización.
  2. 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.
  3. Con el token resultante, llamas a POST /v1/payment-methods para crear el PaymentMethod. 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.