Payer en client connu
Débiter un client par son id, et ce qu'un client connu change sur la page de checkout.
Une fois que vous détenez un id, issu de l'objet customer d'un paiement précédent ou de POST /customers, passez-le et laissez
complètement de côté les champs de contact. Le champ customer accepte l'id sous forme de simple
chaîne, et customer_id accepte la même valeur ; ce sont deux écritures de la même chose.
curl https://api.wajub.com/payments \
-H "Authorization: sk_test.xxxxxxxxxxxxxxxx…" \
-H "Content-Type: application/json" \
-d '{
"amount": 5000,
"currency": "XAF",
"customer": "cus_test_sAaim5apjocIgtlhzJY3wQ8s",
"reference": "order-4173"
}'L'identifiant n'est pas forcément un id. Si la valeur que vous passez ne correspond à aucun id de
client, Wajub l'essaie comme numéro de téléphone, puis comme adresse email.
"customer": "amina@example.com" et "customer": "+237670000000" sont donc tous deux résolus, ce
qui est pratique quand votre propre base stocke l'email et non l'id Wajub.
Un identifiant qui ne correspond à rien donne un 422, pas un nouveau client
C'est le seul endroit où l'API refuse de créer. Passez customer ou customer_id et Wajub
trouvera ce client ou fera échouer l'appel avec un 422 sur le champ utilisé, Customer not found. ; il ne se rabat jamais sur une création. Un id périmé, un client supprimé la semaine dernière ou un id live envoyé en
sandbox font tous échouer le paiement d'emblée. En cas de doute sur l'existence de la fiche,
envoyez plutôt email ou phone.
Ce qu'un client change sur la page de checkout
C'est ce qui rentabilise l'appel supplémentaire. Un paiement rattaché à un client connu affiche une page différente.
| Ce que porte le client | Ce que le checkout en fait |
|---|---|
| Cartes et numéros Mobile Money déjà utilisés | Les propose comme moyens enregistrés, utilisables en un geste, le moyen par défaut en premier, dix au maximum |
preferred_language | Définit la langue de la page, sauf si le réglage d'équipe ou de branding l'emporte |
currency | Devient la devise présélectionnée quand la conversion automatique est activée |
Les moyens enregistrés sont le vrai gain pour les payeurs qui reviennent : le numéro est déjà là, masqué, et ils confirment sur leur téléphone sans le ressaisir.
Enregistrer un moyen de paiement est la décision du payeur
Une carte ou un numéro Mobile Money n'est conservé que si le payeur coche la case sur la page de checkout. Ce n'est jamais déduit ni coché par défaut : une fiche client sans moyen enregistré est donc l'état normal tant que personne n'a donné son accord. Seuls les cartes et le Mobile Money sont réutilisables ; les portefeuilles et les virements bancaires ne sont pas conservés.