GET
/
v1
/
payment-intents
Lister les intentions de paiement
curl --request GET \
  --url https://api.pay.izichange.com/v1/payment-intents \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "status": "<string>",
    "amountRequested": "<string>",
    "currencyRequested": "<string>",
    "requestedCurrencyType": "<string>",
    "amountCryptoExpected": {},
    "assetCode": {},
    "acceptedCoins": [
      "<string>"
    ],
    "totalAmountReceived": "<string>",
    "amountNetMerchant": "<string>",
    "feeAmountTotal": "<string>",
    "amountInRange": {},
    "amountRejected": {},
    "amountToRefund": {},
    "feeAmountOnRange": {},
    "feeAmountOnRejected": {},
    "source": "<string>",
    "merchantReference": {},
    "invoiceId": {},
    "productId": {},
    "posTerminalId": {},
    "irregularStatus": "<string>",
    "paymentResult": {},
    "customerRefundAddress": {},
    "irregularActionBy": {},
    "irregularActionAt": {},
    "irregularRefundPayoutId": {},
    "customerEmail": {},
    "returnUrl": {},
    "createdAt": "<string>",
    "expiresAt": "<string>",
    "paymentLink": "<string>",
    "statusHistory": [
      {}
    ],
    "payins": [
      {
        "id": "<string>",
        "amountGross": "<string>",
        "amountNet": "<string>",
        "feeAmount": "<string>",
        "assetCode": "<string>",
        "status": "<string>",
        "txid": {},
        "createdAt": "<string>"
      }
    ]
  }
]

Autorisations

​
Authorization
string
header
requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Paramètres de requête

​
cursor
string

Identifiant de la dernière intention de la page précédente.

​
take
number

Nombre d'éléments à retourner (défaut 20, max 100).

​
status
string

Filtre sur le statut (waiting_address_selection, pending, confirming, completed, expired, unmatched, cancelled ou irregular).

​
assetCode
string

Filtre sur l'actif crypto utilisé (ex. "USDT.TRX").

​
productId
string

Filtre sur l'identifiant de produit associé.

​
posTerminalId
string

Filtre sur l'identifiant de terminal POS associé.

​
invoiceId
string

Filtre sur l'identifiant de facture associée.

​
merchantReference
string
requis

Réponse

Liste paginée des intentions de paiement.

​
id
string
requis

Identifiant unique de l'intention de paiement.

​
status
string
requis

État courant de l'intention (waiting_address_selection, pending, confirming, completed, expired, unmatched, cancelled).

​
amountRequested
string
requis

Montant demandé exprimé dans la devise initiale — chaîne décimale.

​
currencyRequested
string
requis

Code de la devise initialement demandée (fiat ou crypto).

​
requestedCurrencyType
string
requis

Type de devise initialement demandée ("fiat" ou "crypto").

​
amountCryptoExpected
object
requis

Équivalent crypto figé après sélection de l'actif par le client. null tant que l'actif n'est pas choisi ou si la devise demandée est déjà une crypto.

​
assetCode
object
requis

Code de l'actif crypto choisi par le client (ex. "USDT.TRX"). null tant que l'actif n'est pas sélectionné.

​
acceptedCoins
string[]
requis

Liste des actifs crypto que ce paiement accepte (proposés au client).

​
totalAmountReceived
string
requis

Montant total reçu sur ce paiement — chaîne décimale.

​
amountNetMerchant
string
requis

Montant net cumulé revenant au marchand — chaîne décimale.

​
feeAmountTotal
string
requis

Frais totaux retenus par la plateforme — chaîne décimale.

​
amountInRange
object
requis

Montant reçu dans la fourchette acceptable (litige : portion acceptée).

​
amountRejected
object
requis

Montant reçu hors fourchette acceptable (litige : portion rejetée).

​
amountToRefund
object
requis

Montant à rembourser au client en cas de décision de remboursement.

​
feeAmountOnRange
object
requis

Frais appliqués à la portion acceptée.

​
feeAmountOnRejected
object
requis

Frais appliqués à la portion rejetée (utilisé lors d'un remboursement partiel).

​
source
string
requis

Origine de l'intention (api, dashboard, invoice, product, pos, ...).

​
merchantReference
object
requis

Référence libre fournie par le marchand pour rapprocher ce paiement.

​
invoiceId
object
requis

Identifiant de la facture associée, le cas échéant.

​
productId
object
requis

Identifiant du produit associé, le cas échéant.

​
posTerminalId
object
requis

Identifiant du terminal POS associé, le cas échéant.

​
irregularStatus
string
requis

Statut de litige éventuel (none, pending_decision, encashed, refunded). Différent du statut principal car un litige peut être ouvert sur un paiement déjà complété.

​
paymentResult
object
requis

Détail du résultat de paiement (montants reçus, écarts, ...).

​
customerRefundAddress
object
requis

Adresse de remboursement fournie par le client (masquée). null si non saisie ou pas encore connue.

​
irregularActionBy
object
requis

Identifiant de l'utilisateur ayant statué sur le litige (le cas échéant).

​
irregularActionAt
object
requis

Date à laquelle la décision de litige a été prise — ISO 8601.

​
irregularRefundPayoutId
object
requis

Identifiant du payout généré lors d'un remboursement de litige.

​
customerEmail
object
requis

Email du client (si pré-rempli ou saisi dans le widget).

​
returnUrl
object
requis

URL de redirection après paiement (passée par le marchand).

​
createdAt
string
requis

Date de création — ISO 8601.

​
expiresAt
string
requis

Date d'expiration de l'intention — ISO 8601.

​
paymentLink
string
requis

URL du widget de paiement à présenter au client.

​
statusHistory
object[]
requis

Historique horodaté des transitions de statut.

​
payins
object[]
requis

Liste des dépôts entrants reçus sur cette intention.