DocsTableau de bord

Moyens enregistrés

Enregistrer un moyen

POST/v1/payment-methodspayments:write

Autorisation payments:write. Enregistre une référence de moyen de paiement émise par le prestataire, pour un compte, un acheteur et l’accord qu’il a donné. Jamais un numéro de carte. Elle ne vaut que sur ce compte.

En-têtes

AuthorizationBearer pos_key_…obligatoire
Clé de serveur, pour tout l’espace. Jamais dans un navigateur.
X-Merchant-IDstringobligatoire
L’espace marchand concerné (mrc_…).

Corps

connection_idstringobligatoire
Le compte concerné, obligatoire : son identifiant (con_…) se lit dans GET /v1/connections.
provider_referencestring, 0 à 255obligatoire
La référence émise par le prestataire, jamais un numéro de carte.
customer_referencestring, 0 à 128obligatoire
L’acheteur, tel que votre boutique le nomme. Obligatoire avec save_method.
usage"customer_initiated" | "merchant_initiated"obligatoire
consentobjectobligatoire
mandate_referencestring, 0 à 255
Obligatoire pour des paiements faits sans l’acheteur.
cardobject
Ce que le prestataire dit de la carte, pour que l’acheteur la reconnaisse. Jamais un numéro.

Réponses

200Réussi
400Requête invalide
401Clé absente ou invalide
403Autorisation ou espace refusé
404Ressource introuvable
409Conflit avec une demande existante
429Trop de demandes, réessayez plus tard
503Service momentanément indisponible

Une erreur ne vaut jamais paiement. Le corps donne code, message, request_id et retry_action ; renvoyez la même Idempotency-Key si retry_action le propose.