Documentation/Lister les remboursements
openapi.jsonOuvrir mon espace

Lister les remboursements

GET/v1/refunds

Filtrable par paiement et par statut.

Ce qu’on met dans l’adresse

paymenttexteLes remboursements de ce paiement-là.
status« pending » · « processing » · « succeeded » · « failed »Ne rendre que ceux dans cet état.
limitentierDe 1 à 100. Par défaut 20.
starting_aftertexteL’identifiant de la dernière ligne lue : la page suivante commence après.

La demande

bash
curl -G https://api.payiz.app/v1/refunds \
  -H "Authorization: Bearer sk_test_…" \
  -d payment=pay_01j9x3kq7m4tzv8qhw2n

La réponse

json
{
  "object": "list",
  "url": "/v1/refunds",
  "has_more": false,
  "data": [
    {
      "object": "refund",
      "id": "rem_01j9xb2te8r5mzq4kd7n",
      "payment": "pay_01j9x3kq7m4tzv8qhw2n",
      "amount": 10000,
      "currency": "XOF",
      "status": "processing",
      "reason": "requested_by_customer",
      "fee": 100,
      "fee_returned": 250,
      "amount_debited": 9850,
      "failure_message": null,
      "created": 1790006292,
      "livemode": false
    }
  ]
}

Ce qu’on reçoit

200 · une liste d’objets refund

object« list »Le genre de l’objet rendu : il ne change jamais.
dataliste d’objets refundLes remboursements de la page, du plus récent au plus ancien.
has_morevrai ou fauxVrai : il en reste. Rappelez avec starting_after sur la dernière ligne lue.
urltexteL’adresse qui a servi, sans les filtres.

Enchaîner les pages

Tant que has_more est vrai, rappelez avec starting_after réglé sur l’identifiant de la dernière ligne lue. Les listes vont du plus récent au plus ancien.

© 2026 PayizUne question ? L’aide est dans le rond, en bas à droite.

Lister les remboursements

GET/v1/refunds

Filtrable par paiement et par statut.

Ce qu’on met dans l’adresse

paymenttexteLes remboursements de ce paiement-là.
status« pending » · « processing » · « succeeded » · « failed »Ne rendre que ceux dans cet état.
limitentierDe 1 à 100. Par défaut 20.
starting_aftertexteL’identifiant de la dernière ligne lue : la page suivante commence après.

La demande

bash
curl -G https://api.payiz.app/v1/refunds \
  -H "Authorization: Bearer sk_test_…" \
  -d payment=pay_01j9x3kq7m4tzv8qhw2n

La réponse

json
{
  "object": "list",
  "url": "/v1/refunds",
  "has_more": false,
  "data": [
    {
      "object": "refund",
      "id": "rem_01j9xb2te8r5mzq4kd7n",
      "payment": "pay_01j9x3kq7m4tzv8qhw2n",
      "amount": 10000,
      "currency": "XOF",
      "status": "processing",
      "reason": "requested_by_customer",
      "fee": 100,
      "fee_returned": 250,
      "amount_debited": 9850,
      "failure_message": null,
      "created": 1790006292,
      "livemode": false
    }
  ]
}

Ce qu’on reçoit

200 · une liste d’objets refund

object« list »Le genre de l’objet rendu : il ne change jamais.
dataliste d’objets refundLes remboursements de la page, du plus récent au plus ancien.
has_morevrai ou fauxVrai : il en reste. Rappelez avec starting_after sur la dernière ligne lue.
urltexteL’adresse qui a servi, sans les filtres.

Enchaîner les pages

Tant que has_more est vrai, rappelez avec starting_after réglé sur l’identifiant de la dernière ligne lue. Les listes vont du plus récent au plus ancien.