PaymentMethods

PaymentMethods represent payment methods saved on a Customer profile. They enable recurring and off-session payments without re-entering information.

Endpoints

Méthode	Endpoint	Description
GET	/payment-methods/	List all methods
GET	/payment-methods/{id}/	Retrieve a method
POST	/payment-methods/{id}/attach/	Attach to a Customer
POST	/payment-methods/{id}/detach/	Detach from a Customer

Method types

Type	ID Prefix	Description
mobile_money	mm_	Mobile Money number (Airtel, Moov)
card	card_	Bank card tokenized via Braintree
paypal	pp_	Linked PayPal account

Note

Payment methods are created automatically during a payment with setup_future_usage, via the hosted checkout page, or by attaching them to a Customer with payment_methods.attach().

Objet PaymentMethod

ResponseResponse

jsonCopier

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