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"obligatoireconsentobjectobligatoiremandate_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.