POST
/
v1
/
payment-intents
Créer une intention de paiement
curl --request POST \
  --url https://api.pay.izichange.com/v1/payment-intents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: <idempotency-key>' \
  --data '{}'
{
  "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.

En-têtes

​
idempotency-key
string
requis
​
Idempotency-Key
string

Clé d'idempotence (recommandée) pour éviter la création de doublons en cas de rejeu.

Corps

application/json

The body is of type object.

Réponse

Intention de paiement créée.

​
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.