E-commerce · Guides de recettes
Rattacher un encaissement à sa boutique
Un compte, plusieurs points de vente : storeId dit lequel encaisse, et la réponse le confirme.
1. Déclarer la boutique
Les boutiques se créent dans l'espace marchand. Chacune porte un identifiant sto_* et un code court que vous choisissez, par exemple PAITA. Les deux sont acceptés par l'API.
2. Passer storeId à la création
Le champ est au premier niveau de la requête, pas dans order.
{
"order": { "reference": "CMD-001", "amount": 5000, "currency": "XPF" },
"storeId": "PAITA",
"redirectUrl": "https://example.com/return",
"notificationUrl": "https://example.com/webhook"
}3. Lire l'écho store
La réponse 201 restitue la boutique retenue dans store — null si l'encaissement n'en porte aucune. C'est cet écho qui permet le rapprochement, sans rappeler l'API.
Six refus possibles, tous en 400, tous nommés : UNKNOWN_STORE, STORE_INACTIVE, STORE_KIND_MISMATCH (un point de vente physique n'encaisse pas à distance), STORE_CONTRACT_INACTIVE, STORE_CONTRACT_CONFLICT, STORE_KEY_MISMATCH.
Sur un rejeu d'idempotence, la réponse est 200 et store est absent plutôt que null : ce chemin ne relit pas le paiement déjà créé, et null affirmerait à tort qu'il n'a pas de boutique. Lisez-la alors sur GET /api/v1/payments/{id}.