Passer au contenu principal

​
1. Récupérez votre clé API

Créez une clé secrète (sk_...) depuis le dashboard Orqex. Gardez-la côté serveur.

​
2. Créez une intention de paiement

curl https://api.orqex.com/v1/payment/intents \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50,
    "currency": "XOF",
    "description": "Commande #1024",
    "customer": { "email": "[email protected]", "first_name": "Ama", "last_name": "Mensah" }
  }'

​
3. Lancez une tentative de paiement

Choisissez une méthode et un pays. Pour le mobile money, incluez le téléphone du payeur.
SDK PHP
$intent = $orqex->paymentIntents()->attempt($intent->id, [
    'method_code' => 'momo_mtn',
    'country'     => 'CI',
    'phone'       => ['number' => '0700000000', 'country' => 'CI'],
]);

​
4. Résolvez l’action suivante

SDK PHP
$action = $intent->active_attempt?->next_action;

switch ($action?->type) {
    case 'redirect_to_url':  // redirigez le client vers $action->url
    case 'collect_otp':      // collectez un OTP, puis confirm()
    case 'approve_on_phone': // demandez au client de valider sur son téléphone
}
Si la méthode exige un OTP, confirmez-le :
SDK PHP
$intent = $orqex->paymentIntents()->confirm($intent->id, ['otp' => '123456']);

​
5. Lisez le statut final

SDK PHP
$intent = $orqex->paymentIntents()->retrieve($intent->id);

if ($intent->status === 'completed') {
    // honorez la commande
}

Suite : Authentification

Clés secrètes, environnements et idempotence.