Ir al contenido

PaymentMethods

Los PaymentMethods representan métodos de pago guardados en un perfil de Customer. Permiten los pagos recurrentes y off-session sin volver a introducir los datos.

Endpoints

MéthodeEndpointDescription
GET/payment-methods/Listar todos los métodos
GET/payment-methods/{id}/Recuperar un método
POST/payment-methods/{id}/attach/Asociar a un Customer
POST/payment-methods/{id}/detach/Desasociar de un Customer

Tipos de métodos

TipoPrefijo del IDDescripción
mobile_moneymm_Número de Mobile Money (Airtel, Moov)
cardcard_Tarjeta bancaria tokenizada mediante Braintree
paypalpp_Cuenta de PayPal vinculada
Note

Los métodos de pago se crean automáticamente al realizar un pago con setup_future_usage, a través de la página de checkout alojada, o asociándolos a un Customer con payment_methods.attach().

Objeto PaymentMethod

ResponseRespuesta
json
{
  "id": "mm_xxxxxxxxxxxx",
  "object": "payment_method",
  "type": "mobile_money",
  "mobile_money": {
    "phone_number": "+24177654321",
    "operator": "airtel",
    "country": "GA"
  },
  "customer": "cust_xxxx",
  "livemode": true,
  "created_at": "2026-03-01T10:00:00Z"
}