Available endpoints
All the endpoints that make up the QR Code integration, from the initial infrastructure setup to payment management. For third-party integrations, authenticate your API calls using OAuth.
Stores represent the physical locations of your business. Each store groups the POS terminals where QR Codes are generated.
| Operation | Path | Description |
| Create storePOST | /users/{user_id}/stores | Registers a physical store where POS terminals with QR Code will operate. |
| Get storeGET | /stores/{id} | Returns the registration data of a store: name, business hours, location, and external identifier. |
| Search storesGET | /users/{user_id}/stores/search | Searches stores by external_id or other available parameters; returns paginated results. |
| Update storePUT | /users/{user_id}/stores/{id} | Updates the configuration data of an existing store. |
| Delete storeDELETE | /users/{user_id}/stores/{id} | Deletes a store and unlinks it from its POS terminals. |
Each POS is a point of sale within a store associated with a static QR Code. In dynamic or hybrid mode, the order also generates a unique QR per transaction.
| Operation | Path | Description |
| Create POSPOST | /pos | Creates a POS in a store, generates the static QR Code, and allows defining the point of sale operating mode. |
| Get POSGET | /pos/{id} | Returns the detail of a POS terminal, including the qr_code to display at the point of sale. |
| Search POS terminalsGET | /pos | Searches POS by external_id or other available parameters; returns paginated results. |
| Update POSPUT | /pos/{id} | Updates the configuration of an existing POS terminal. |
| Delete POSDELETE | /pos/{id} | Deletes a POS terminal and its associated QR Code. |
Orders are payment requests processed via QR Code. Depending on the configured mode, the order is assigned to the static QR of the POS, generates a dynamic QR per transaction, or activates both in hybrid mode; in all cases the customer pays by scanning the code with the Mercado Pago app.
| Operation | Path | Description |
| Create orderPOST | /v1/orders | Creates a payment order processed via QR Code; in static mode it is assigned to the POS QR, in dynamic mode it generates a per-transaction QR, and in hybrid mode it activates both; the customer pays by scanning the code with the Mercado Pago app. |
| Get order by IDGET | /v1/orders/{id} | Returns the status and detail of an order, including the payment result. |
| Refund an orderPOST | /v1/orders/{id}/refund | Refunds a paid order, fully or partially. |
| Cancel order by IDPOST | /v1/orders/{id}/cancel | Cancels a pending order before it is paid by the customer. |
| Operation | Path | Description |
| Get chargebackGET | /v1/chargebacks/{id} | Returns the detail of a chargeback: dispute status, affected amount, and deadline to respond. |