Rembourser un paiement

curl --request POST \
  --url https://api.pay.izichange.com/v1/payouts/refund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "paymentIntentId": "3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "amount": "49.90",
  "destinationAddress": "TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC",
  "feeBearer": "customer",
  "totpCode": "123456",
  "idempotencyKey": "refund-2026-07-08-0001"
}
'

import requests

url = "https://api.pay.izichange.com/v1/payouts/refund"

payload = {
    "paymentIntentId": "3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
    "amount": "49.90",
    "destinationAddress": "TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC",
    "feeBearer": "customer",
    "totpCode": "123456",
    "idempotencyKey": "refund-2026-07-08-0001"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    paymentIntentId: '3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d',
    amount: '49.90',
    destinationAddress: 'TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC',
    feeBearer: 'customer',
    totpCode: '123456',
    idempotencyKey: 'refund-2026-07-08-0001'
  })
};

fetch('https://api.pay.izichange.com/v1/payouts/refund', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pay.izichange.com/v1/payouts/refund",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'paymentIntentId' => '3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d',
    'amount' => '49.90',
    'destinationAddress' => 'TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC',
    'feeBearer' => 'customer',
    'totpCode' => '123456',
    'idempotencyKey' => 'refund-2026-07-08-0001'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pay.izichange.com/v1/payouts/refund"

	payload := strings.NewReader("{\n  \"paymentIntentId\": \"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n  \"amount\": \"49.90\",\n  \"destinationAddress\": \"TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC\",\n  \"feeBearer\": \"customer\",\n  \"totpCode\": \"123456\",\n  \"idempotencyKey\": \"refund-2026-07-08-0001\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.pay.izichange.com/v1/payouts/refund")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"paymentIntentId\": \"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n  \"amount\": \"49.90\",\n  \"destinationAddress\": \"TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC\",\n  \"feeBearer\": \"customer\",\n  \"totpCode\": \"123456\",\n  \"idempotencyKey\": \"refund-2026-07-08-0001\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pay.izichange.com/v1/payouts/refund")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"paymentIntentId\": \"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n  \"amount\": \"49.90\",\n  \"destinationAddress\": \"TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC\",\n  \"feeBearer\": \"customer\",\n  \"totpCode\": \"123456\",\n  \"idempotencyKey\": \"refund-2026-07-08-0001\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "merchantReference": {},
  "payoutType": "<string>",
  "amount": "<string>",
  "assetCode": "<string>",
  "destinationAddress": "<string>",
  "destinationType": "<string>",
  "destinationMemo": {},
  "feeAmount": "<string>",
  "networkFeeAmount": {},
  "networkFeeAssetCode": {},
  "networkFeeUsdEquivalent": {},
  "txid": "9f4c1a2b3d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f8",
  "txUrl": "https://tronscan.org/#/transaction/9f4c1a2b3d5e6f70",
  "status": "<string>",
  "failureReason": {},
  "feeBearer": "<string>",
  "kytStatus": {},
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "statusHistory": [
    {}
  ]
}

POST

payouts

refund

Rembourser un paiement

curl --request POST \
  --url https://api.pay.izichange.com/v1/payouts/refund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "paymentIntentId": "3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "amount": "49.90",
  "destinationAddress": "TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC",
  "feeBearer": "customer",
  "totpCode": "123456",
  "idempotencyKey": "refund-2026-07-08-0001"
}
'

import requests

url = "https://api.pay.izichange.com/v1/payouts/refund"

payload = {
    "paymentIntentId": "3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
    "amount": "49.90",
    "destinationAddress": "TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC",
    "feeBearer": "customer",
    "totpCode": "123456",
    "idempotencyKey": "refund-2026-07-08-0001"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    paymentIntentId: '3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d',
    amount: '49.90',
    destinationAddress: 'TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC',
    feeBearer: 'customer',
    totpCode: '123456',
    idempotencyKey: 'refund-2026-07-08-0001'
  })
};

fetch('https://api.pay.izichange.com/v1/payouts/refund', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pay.izichange.com/v1/payouts/refund",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'paymentIntentId' => '3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d',
    'amount' => '49.90',
    'destinationAddress' => 'TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC',
    'feeBearer' => 'customer',
    'totpCode' => '123456',
    'idempotencyKey' => 'refund-2026-07-08-0001'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pay.izichange.com/v1/payouts/refund"

	payload := strings.NewReader("{\n  \"paymentIntentId\": \"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n  \"amount\": \"49.90\",\n  \"destinationAddress\": \"TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC\",\n  \"feeBearer\": \"customer\",\n  \"totpCode\": \"123456\",\n  \"idempotencyKey\": \"refund-2026-07-08-0001\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.pay.izichange.com/v1/payouts/refund")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"paymentIntentId\": \"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n  \"amount\": \"49.90\",\n  \"destinationAddress\": \"TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC\",\n  \"feeBearer\": \"customer\",\n  \"totpCode\": \"123456\",\n  \"idempotencyKey\": \"refund-2026-07-08-0001\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pay.izichange.com/v1/payouts/refund")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"paymentIntentId\": \"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n  \"amount\": \"49.90\",\n  \"destinationAddress\": \"TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC\",\n  \"feeBearer\": \"customer\",\n  \"totpCode\": \"123456\",\n  \"idempotencyKey\": \"refund-2026-07-08-0001\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "merchantReference": {},
  "payoutType": "<string>",
  "amount": "<string>",
  "assetCode": "<string>",
  "destinationAddress": "<string>",
  "destinationType": "<string>",
  "destinationMemo": {},
  "feeAmount": "<string>",
  "networkFeeAmount": {},
  "networkFeeAssetCode": {},
  "networkFeeUsdEquivalent": {},
  "txid": "9f4c1a2b3d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f8",
  "txUrl": "https://tronscan.org/#/transaction/9f4c1a2b3d5e6f70",
  "status": "<string>",
  "failureReason": {},
  "feeBearer": "<string>",
  "kytStatus": {},
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "statusHistory": [
    {}
  ]
}

Autorisations

Authorization

string

header

requis

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

Corps

application/json

paymentIntentId

string<uuid>

requis

Identifiant du paiement à rembourser. C'est l'id retourné à la création du paiement ; le paiement doit être encaissé. L'actif et le montant remboursable en sont déduits automatiquement.

Exemple:

"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"

amount

string

Montant à rembourser, en unités de l'actif du paiement, pour un remboursement partiel. Chaîne de caractères, jamais un nombre JSON : un montant crypto passé en number est arrondi par la précision flottante. Omis, le montant net reçu par le marchand est intégralement remboursé.

Pattern: ^\d+(\.\d+)?$

Exemple:

"49.90"

destinationAddress

string

Adresse crypto vers laquelle rembourser, sur le réseau de l'actif du paiement. Omise, l'adresse de remboursement enregistrée sur le paiement est utilisée ; ce champ devient obligatoire si le paiement n'en porte aucune.

Exemple:

"TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC"

feeBearer

enum<string>

défaut:customer

Qui supporte les frais réseau du remboursement.

customer (défaut) : les frais sont prélevés sur le montant remboursé.
merchant : vous absorbez les frais ; le client reçoit le montant en entier.

Options disponibles:

customer,

merchant

Exemple:

"customer"

totpCode

string

Code TOTP à 6 chiffres, issu de votre application d'authentification. Requis uniquement pour les appels authentifiés par session utilisateur (dashboard) ; les appels par clé API n'en ont pas besoin.

Pattern: ^\d{6}$

Exemple:

"123456"

idempotencyKey

string

Clé d'idempotence. Rejouer la même clé retourne le remboursement déjà créé au lieu d'en créer un second. Omise, une clé dérivée du paiement est générée, ce qui garantit un seul remboursement par paiement. Peut aussi être transmise via l'en-tête Idempotency-Key.

Exemple:

"refund-2026-07-08-0001"

Réponse

Remboursement créé.

string

requis

Identifiant unique du payout.

merchantReference

object | null

requis

Référence libre attachée par le marchand (optionnelle).

payoutType

string

requis

Catégorie du payout : retrait crypto standard, transfert interne entre marchands, remboursement d'un paiement, ou leg crypto d'un settlement.

amount

string

requis

Montant brut envoyé — chaîne décimale (préserve la précision).

assetCode

string

requis

Code de l'actif crypto (USDT.TRC20, BTC, …).

destinationAddress

string

requis

Adresse de destination — adresse blockchain, email interne ou identifiant d'un autre compte IzichangePay selon destinationType.

destinationType

string

requis

Type de destination : adresse blockchain, email interne ou identifiant d'un autre compte marchand de la plateforme.

destinationMemo

object | null

requis

Mémo/tag requis pour les chaînes memo-type (XRP, TON, Stellar).

feeAmount

string

requis

Frais facturés par IzichangePay — chaîne décimale.

networkFeeAmount

object | null

requis

Frais réseau (gas) effectivement payés à la blockchain — chaîne décimale, renseigné après diffusion.

networkFeeAssetCode

object | null

requis

Asset dans lequel les frais réseau ont été payés : le BASE COIN de la chaîne (ex. TRX pour un retrait USDT.TRC20, BNB pour USDT.BEP20), jamais l'asset du retrait. À utiliser pour libeller networkFeeAmount.

networkFeeUsdEquivalent

object | null

requis

Contre-valeur USD des frais réseau, pour comparer des frais payés dans des monnaies natives différentes. Indicatif de reporting : rien n'est facturé en USD. Renseigné seulement à la CONFIRMATION, quand le coût réel est constaté on-chain — null tant que le payout n'est pas confirmé.

txid

object | null

requis

Hash de la transaction on-chain, vérifiable sur un explorateur de blocs. Renseigné une fois la transaction diffusée : null tant que le retrait n'a pas atteint la chaîne, et sur ce qui n'y arrive jamais (transferts internes, confirmations manuelles hors-chaîne).

Exemple:

"9f4c1a2b3d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f8"

txUrl

object | null

requis

URL de la transaction sur un explorateur de blocs, pré-résolue par le serveur. null si le hash n'est pas encore connu ou si aucun explorateur n'est configuré pour cet actif.

Exemple:

"https://tronscan.org/#/transaction/9f4c1a2b3d5e6f70"

status

string

requis

Statut courant du payout (pending, approved, confirmed, failed, etc.).

failureReason

object | null

requis

Message d'erreur sécurisé pour les payouts non finalisés (échec, en attente d'examen). null pour les payouts en bonne marche.

feeBearer

string

requis

Indique qui supporte les frais : le marchand (montant débité = amount + fee) ou le client (sur les remboursements).

kytStatus

object | null

requis

Statut du contrôle KYT (Know Your Transaction) si applicable.

createdAt

string

requis

Date de création — ISO 8601.

updatedAt

string

requis

Date de dernière mise à jour — ISO 8601.

statusHistory

object[]

requis

Historique des transitions de statut, chaque entrée comportant le statut, l'horodatage, la source et une note éventuelle.

Introduction

Endpoints

Rembourser un paiement

Autorisations

Corps

Réponse