Home
Documentation
Resources
Certifications
Community

Resources

Check for updates on our solutions and system performance, or request technical support.

Community

Get the latest news, ask others for help and share your knowledge.

Refund order - In person payments - Mercado Pago Developers

Intelligent search powered by OpenAI 

Refund order

POST

https://api.mercadopago.com/v1/orders/{order_id}/refund
This endpoint allows to create a refund for a payment transactions associated with an order for Mercado Pago Point. In case of success, the request will return a response with status 200.
Request's parameters
PATH
order_id
string

REQUIRED

ID of the order that contains the associated payment transaction to be refunded. This value is returned in the response to the "Create order" request.
HEADER
X-Idempotency-Key
string

REQUIRED

This feature allows you to safely retry requests without the risk of accidentally performing the same action more than once. This is useful for avoiding errors, such as creating two identical payments. To ensure that eac...View more
Response parameters
id
string
Identifier of the order to be refunded, received in the response to its creation.
status
string
Current status of the order or the transaction.
refunded: The order has been succesfully refunded.
status_detail
string
Details about the refund status. It is returned exclusively when the order is reimbursed through the API
transactions
object
Contains information about the transaction associated with the order.
Errors

400Error.

empty_required_header

The 'X-Idempotency-Key' header is required and was not sent. Make the requisition again including it.

401Error.

unauthorized

The value sent as Access Token is incorrect. Please check and try again with the correct value.

404Error.

order_not_found

The value sent as Access Token is incorrect, therefore the order could not be found. Please check and try again with the correct value.

409Error.

idempotency_key_already_used

The value sent as the idempotency header has already been used with a different request within the last 24 hours. Please try the request again sending a new value.

500Error.

idempotency_validation_failed

Validation fail. Please try submitting the request again.

500

Generic error. Please try submitting the request again.

Request
curl -X POST \
    'https://api.mercadopago.com/v1/orders/{order_id}/refund'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    
Sample answer
{
  "id": "123",
  "status": "refunded",
  "status_detail": "refunded",
  "transactions": {
    "refunds": [
      {
        "id": "ref_01J67CQQH5904WDBVZEM1234D",
        "transaction_id": "pay_01J67CQQH5904WDBVZEM4JMEP3",
        "reference_id": "12345678",
        "amount": "24.90",
        "status": "processed"
      }
    ]
  }
}