Passer au contenu principal

​
Récupérer une intention de paiement

curl https://api.orqex.com/v1/payment/intents/pi_a1b2c3d4e5f6 \
  -H "Authorization: Bearer sk_live_xxx"
Renvoie l’objet intention de paiement complet. Voir Créer un paiement pour la structure de réponse complète.

​
Lister les intentions de paiement

curl "https://api.orqex.com/v1/payment/intents?per_page=20" \
  -H "Authorization: Bearer sk_live_xxx"

​
Paramètres de requête

​
per_page
integer
Nombre d’intentions par page. Par défaut 15, maximum 100.
​
cursor
string
Curseur opaque pour la page suivante. Passez la valeur de meta.next_cursor de la réponse précédente. Omettez pour commencer depuis la première page.
​
customer_id
string
Filtre par identifiant de client (ex. cus_...). Renvoie uniquement les intentions appartenant à ce client.
​
status
string
Filtre par statut. Valeurs acceptées : pending, completed, failed, expired, partially_refunded, refunded. Voir Cycle de vie du paiement.
​
created_at[gte]
string
Date de début (ISO 8601, incluse). Filtre les intentions créées à partir de cette date.
​
created_at[lte]
string
Date de fin (ISO 8601, incluse). Filtre les intentions créées jusqu’à cette date.

​
Enveloppe de réponse

{
  "data": [
    { "id": "pi_a1b2c3d4e5f6", "status": "completed", "...": "..." }
  ],
  "meta": {
    "per_page": 20,
    "next_cursor": "eyJpZCI6Mn0",
    "prev_cursor": null
  }
}
​
data
array
Tableau d’objets intention de paiement.
​
meta
object
La pagination est basée sur un curseur — la pagination par offset n’est pas supportée. Pour itérer sur toutes les intentions, suivez meta.next_cursor jusqu’à ce qu’il soit null.

​
Polling pour le statut final

Si vous ne pouvez pas recevoir de webhooks, pollez l’endpoint de récupération jusqu’à ce que status atteigne un état terminal (completed, failed, expired, partially_refunded, refunded). Utilisez un backoff exponentiel et arrêtez après un timeout raisonnable.
PHP (SDK)
$intent = $orqex->paymentIntents()->retrieve('pi_a1b2c3d4e5f6');

while ($intent->status === 'pending') {
    sleep(5);
    $intent = $orqex->paymentIntents()->retrieve('pi_a1b2c3d4e5f6');
}
Les webhooks sont fortement préférés au polling. Voir Webhooks.