Afficher le portefeuille sur votre page de paiement

Montrer les cartes déjà enregistrées, dans le bon ordre, sans jamais manipuler de numéro.

1. Lister les cartes du client

La réponse porte la marque, les quatre derniers chiffres, l'échéance et le rang. Jamais le numéro complet : il n'existe pas de votre côté, et c'est le point de la tokenisation.

get/api/v1/payment-methods?customerId=cus_2KmBz9aQp4nT8R

{
  "data": [
    { "id": "pm_2Nk...", "brand": "VISA", "last4": "0007",
      "expMonth": 12, "expYear": 2028, "isDefault": true, "rank": 1 }
  ]
}

2. Laisser changer la carte par défaut

PUT /api/v1/payment-methods/{id}/default promeut une carte et rétrograde l'ancienne. L'appel est idempotent : le rejouer ne change rien.

3. Laisser retirer une carte

La suppression est logique, pas physique : la carte cesse d'être utilisable. Si elle était la carte par défaut, le rang immédiatement inférieur reprend ce rôle automatiquement — n'écrivez pas cette règle vous-même.