Page de paiement hébergée

Pour intégrer SOAMTAR sans collecter le numéro de téléphone du client de votre côté, il suffit d'omettre provider dans POST/v1/payments.

Fonctionnement

1. Créez une transaction sans provider :

POST /v1/payments
{
  "merchant_ref": "ORDER-001",
  "amount": "150.00",
  "currency": "SLE"
}

2. SOAMTAR renvoie :

{
  "data": {
    "status": "initiated",
    "payment_url": "https://app.so-amtar.com/pay/checkout/0e85b3c2-..."
  }
}

3. Redirigez le payeur vers payment_url. Sur cette page hébergée par SOAMTAR (en anglais), il saisit son numéro Orange Money, puis confirme la demande sur son téléphone avec son code PIN.

4. À la fin, le payeur est redirigé vers votre success_url ou failed_url.

5. Vous recevez un webhook payment.success / payment.failed / payment.cancelled exactement comme avec une intégration directe.

Quand utiliser la page hébergée

Cas	Choix recommandé
Site e-commerce simple où vous collectez déjà le numéro	API directe avec provider et phone
Vous ne voulez pas gérer le numéro du payeur	Page hébergée
Application mobile native	API directe + écran natif
Lien de paiement partagé (WhatsApp, SMS)	Lien de paiement depuis le dashboard
Intégration sans backend	Page hébergée via un lien de paiement

Personnalisation

Dashboard → Checkout → Branding :

• Logo
• Couleur principale
• Texte d'accueil
• URL des CGV et des mentions légales

Liens de paiement

Pour un lien réutilisable et partageable, créez-le depuis Dashboard → Liens de paiement. Chaque visite ouvre une page de paiement hébergée.

Sécurité

• payment_url contient un identifiant de transaction non devinable (entropie cryptographique).
• Le lien reste valide jusqu'à la fin de la fenêtre d'expiration configurée.
• Aucun compte n'est nécessaire pour le payeur (paiement invité).
• L'interrogation du statut depuis la page passe par un endpoint dédié, à débit limité.