⌘ K

Tableau de bord

Équipe et accès

Créer un espace

POST/v1/merchants

En-têtes

AuthorizationBearer pos_test_…obligatoire: Clé de serveur. Jamais dans un navigateur.
X-Merchant-IDstringobligatoire: L’espace marchand concerné (mrc_…).
X-Environment"test"obligatoire: Seule valeur acceptée tant que la production n’est pas ouverte.

Corps

organization_idstringobligatoire
namestringobligatoire
country"AT" | "BE" | "BG" | "CY" | "CZ" | "DE" | "DK" | "EE" | "ES" | "FI" | "FR" | "GR" | "HR" | "HU" | "IE" | "IT" | "LT" | "LU" | "LV" | "MT" | "NL" | "PL" | "PT" | "RO" | "SE" | "SI" | "SK": Pays d'immatriculation de l'espace marchand (États membres de l'UE, ISO 3166-1 alpha-2). France si absent.

Réponses

201Créé
400Requête invalide
401Clé absente ou invalide
403Autorisation ou espace refusé
429Trop de demandes, réessayez plus tard
500Request rejected; no success is implied.

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.

Requête

curl -X POST "$PAYMENT_OS_API/v1/merchants" \
  -H "Authorization: Bearer $PAYMENT_OS_KEY" \
  -H "X-Merchant-ID: $MERCHANT_ID" \
  -H "X-Environment: test" \
  -d '{ "organization_id": "…", "name": "…" }'