Premier paiement en 5 minutes

Allez dans Développeur → Clés API et cliquez sur Créer une clé. Donnez-lui un libellé (ex : "Test local"), sélectionnez les permissions full_access et créez la clé. Copiez immédiatement le secret qui s'affiche : il ne sera plus jamais visible.

Depuis votre terminal :

curl -X POST https://staging.mobupay.nc/api/v1/payments/links \
  -H "Authorization: Bearer sk_test_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "order": {
      "amount": 1000,
      "currency": "XPF",
      "reference": "CMD-001"
    },
    "redirectUrl": "https://example.com/return",
    "notificationUrl": "https://example.com/webhook",
    "expiresIn": 3600
  }'

La réponse contient un checkoutUrl : l'URL où envoyer votre client pour qu'il paie.

Ouvrez la checkoutUrl retournée à l'étape précédente dans votre navigateur. Sur la page de paiement, utilisez une carte de test du tableau Cartes de test (par exemple 4970 1090 0000 0007 qui déclenche un 3DS Challenge réussi).

• Date d'expiration : n'importe quelle date future
• CVV : 123
• Titulaire : n'importe quel nom

Après paiement, Mobupay envoie une requête POST signée à votre notificationUrl. Le body ressemble à :

{
  "id": "evt_xxxxxxxx",
  "type": "payment.succeeded",
  "createdAt": "2026-05-14T12:34:56Z",
  "data": {
    "paymentId": "pay_xxxxxxxx",
    "amount": 1000,
    "currency": "XPF",
    "status": "CAPTURED",
    "reference": "CMD-001"
  }
}

La signature HMAC est dans le header X-Mobupay-Signature. Voir le guide Webhooks pour la vérifier.