Home
Documentation
Resources
Partners
Community

Resources

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

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

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

Online payments
In-person payments
Tools and resources
APIs and SDKs
Create refund intent - Refund intent - Mercado Pago Developers
Create refund intent

POST

https://api.mercadopago.com/point/integration-api/devices/{deviceid}/refund
This endpoint allows to create a refund intent, where you can specify the details of the transaction that you are willing to refund. This intent must be assigned to the device that processed the original payment. That is, you will be able to start a process of returning the money associated with a previous transaction, and it will be processed on the assigned Point device.
Request's parameters
HEADER
x-test-scope
string
This is a temporary header. It should be used only in the development stage with the value "sandbox". When going to production, it should be removed
PATH
deviceId
string

REQUIRED

Identifier of the device that will receive the refund intent, for example "PAX_A910__SMARTPOS1234345545". If you don't know this value, you can send a GET to "Search payment intent endpoint"
BODY
payment_id
string

REQUIRED

Identification number of the payment to refund, for example "65412345". This payment must be already processed, not an intent.
Response parameters
id
string
Refund intent identifier
device_id
string
Identifier of the device to which the refund intent was assigned
payment_id
string
Identification number of the payment to refund.
Errors

400Error

400

Bad request - Field is missing o incorrect

401Error

401

Unauthorized - Token is invalid or expired

403Error

403

Forbidden - Integrator isn't registered

404Error

404

Not Found - Device or Payment not found

409Error

409

Conflict error - Device has a queued intent

500Error

500

Internal server error

Request
curl -X POST \
    'https://api.mercadopago.com/point/integration-api/devices/{deviceid}/refund'\
    -H 'Content-Type: application/json' \
       -H 'x-test-scope: sandbox' \
       -H 'Authorization: Bearer TEST-8971*********918-01191*********5874530a4*********4799fdf-1*********' \
    -d '{
  "payment_id": "12345678"
}'
Sample answer
{
  "id": "7f25f9aa-eea6-4f9c-bf16-a341f71ba2f1",
  "device_id": "PAX_A910__SMARTPOS1234345545",
  "payment_id": "12345678"
}