List refund reasons

curl --request GET \
  --url http://localhost:4011/v1/refunds/reasons \
  --header 'Authorization: Bearer <token>'

[
  {
    "code": "MD06",
    "description": "Fraud"
  }
]

GET

refunds

reasons

List refund reasons

curl --request GET \
  --url http://localhost:4011/v1/refunds/reasons \
  --header 'Authorization: Bearer <token>'

[
  {
    "code": "MD06",
    "description": "Fraud"
  }
]

Authorization

string

header

required

JWT Bearer token authentication. Obtain token from /v1/login/oauth/access_token endpoint using client credentials (clientId and clientSecret).

Include token in Authorization header: Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Token expires after 3600 seconds (1 hour).

List of refund reasons retrieved successfully

code

enum<string>

required

Refund reason codes as defined by Brazilian Central Bank (BACEN). Standardized codes used when requesting transaction refunds.

Valid values:

FR01 = Fraud (Transaction identified as fraudulent)
AC03 = Invalid creditor account (Recipient account is invalid or doesn't exist)
AG01 = Transaction forbidden (Transaction type not allowed for this account)
MD06 = Refund requested by receiver (Payee requested the refund)
BE01 = Inconsistent data (Transaction data contains inconsistencies)
AC07 = Closed account (Recipient account has been closed)

Available options:

FR01,

AC03,

AG01,

MD06,

BE01,

AC07

Example:

"MD06"

description

string

required

Human-readable description of the refund reason code.

Example:

"Fraud"

⌘I