Available endpoints
All endpoints that make up the Mercado Pago Point integration, from the initial infrastructure setup to the management of charges. For third-party integrations, authenticate your API calls using OAuth.
Stores represent the physical locations of your business. Each store groups the POS and Point terminals that operate at that location.
| Operation | Path | Description |
| Create storePOST | /users/{user_id}/stores | Registers a physical store where the POS and Point terminals will operate. |
| Search storesGET | /users/{user_id}/stores/search | Searches stores by external_id or other available parameters; returns paginated results. |
| Get storeGET | /stores/{id} | Returns the registration data of a store: name, business hours, location, and external identifier. |
| 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. |
Each POS is a point of sale within a store. When creating it, you can link it to a Point terminal so it receives the payment orders.
| Operation | Path | Description |
| Create POSPOST | /pos | Creates a POS in a store and links it to a Point terminal to process payments. |
| Search POSGET | /pos | Searches POS by external_id or other available parameters; returns paginated results. |
| Get POSGET | /pos/{id} | Returns the detail of a POS, including its status and configuration. |
| Update POSPUT | /pos/{id} | Updates the configuration of an existing POS. |
| Delete POSDELETE | /pos/{id} | Deletes a POS and unlinks the associated terminal. |
Point terminals are the physical Mercado Pago Point devices associated with your account. You can query them and configure their operation mode via API.
| Operation | Path | Description |
| Get terminal listGET | /terminals/v1/list | Lists the terminals available for the account; returns the identifier, operating mode, and associated POS for each one. |
| Update terminal operation modePATCH | /terminals/v1/setup | Changes the terminal's operation mode between STANDALONE and PDV. |
Orders are the payment requests sent to the terminal. Your backend creates the order with the amount and the target POS; the terminal receives it automatically and the customer makes the payment.
| Operation | Path | Description |
| Create orderPOST | /v1/orders | Creates a payment order and sends it to the terminal linked to the POS; the customer makes the payment. |
| Get order by IDGET | /v1/orders/{id} | Returns the status and detail of an order, including the payment result on the terminal. |
| Cancel order by IDPOST | /v1/orders/{id}/cancel | Cancels a pending order before it is processed by the terminal. |
| Refund an orderPOST | /v1/orders/{id}/refund | Refunds a processed order, fully or partially. |
| Simulate order statusPOST | /v1/orders/{id}/events | Simulates the result of an order in a test environment with the statuses approved, rejected, or cancelled, without processing a real payment. |
| Operation | Path | Description |
| Get chargebackGET | /v1/chargebacks/{id} | Returns the detail of a chargeback: dispute status, affected amount, and deadline to respond. |