Refund an order - V1

Deprecated

PUT

/order/v1/refund

• Production
• Sandbox

Refund an order by the way only order with payment methods BINANCE_PAY, PIX and SPEI are allowed to refund. For other payment methods, we are implementing them.

NOTE: Please, to authenticate use the scope: “api://app-order-prd”

Authorizations

• Bearer

Parameters

Header Parameters

idempotency-key

required

string format: uuid

A unique identifier for the message with a maximum of 64 characters (we recommend a UUID).

Request Body ^required

object

orderId

required

Order id

string

Example

d8a17574-4002-4093-aee1-e435b9c18cdc

reason

required

Reason for Refund.

For orders of Mexico the reason must be one of the follwoing values bellow:

• DUPLICATE
• FRAUDULENT
• REQUESTED_BY_CUSTOMER
• OTHER

string

>= 5 characters <= 100 characters

Example

Customer requested or order was not delivered

requestedBy

required

Who requested the refund

object

name

required

Requester name

string

Example

Jhon Doe

email

required

Requester email

string

Example

jhon.doe@domain.com

Example

{
  "name": "Jhon Doe",
  "email": "jhon.doe@domain.com"
}

Responses

200

The resource was returned successfully

object

id

required

Refund Id

string

Example

b6210f60-479e-452c-ae75-e0c4157a383b

orderId

required

Order Id

string

Example

52beec72-8521-406f-a31d-c5b66e22b6b4

amount

required

Amount to be refunded

string

Example

100

reason

required

Reason for refund

string

Example

Customer requested or order was not delivered

requestedBy

required

Who requested the refund

object

name

required

Requester name

string

Example

Jhon Doe

email

required

Requester email

string

Example

jhon.doe@domain.com

Example

jhon.doe@email.com

status

required

Refund status

string

Example

INITIAL

createdAt

required

Refund create datetime

string

Example

2021-01-01T00:00:00.000Z

endToEndId

required

Refund end to end id

string

400

The request is not valid

Array<string>

401

Unauthorized Request

Array<string>

500

An unexpected error occurred inside the server

Array<string>