---
product_landing_hero:
 - title: QR Code
 - message: QR Code allows offering instant payments through static, dynamic, or hybrid codes linked to your point of sale. The API manages the complete payment lifecycle and automatic reconciliation with Mercado Pago. This reference describes the available endpoints and how to interact with them.
 - info: Looking for integration steps? [Go to the QR Code documentation](/developers/en/docs/qr-code/overview).
---

## 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](/developers/en/reference/authentication/oauth/_oauth_token/post).

:::AccordionComponent{title="Physical stores" pill="Core"}

Stores represent the physical locations of your business. Each store groups the POS terminals where QR Codes are generated.

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Create store" href="/developers/en/reference/in-person-payments/qr-code/stores/create-store/post" color="green"} | `/users/{user_id}/stores` | Registers a physical store where POS terminals with QR Code will operate. |
| :TagComponent{tag="GET" text="Get store" href="/developers/en/reference/in-person-payments/qr-code/stores/get-store/get" color="accent"} | `/stores/{id}` | Returns the registration data of a store: name, business hours, location, and external identifier. |
| :TagComponent{tag="GET" text="Search stores" href="/developers/en/reference/in-person-payments/qr-code/stores/search-store/get" color="accent"} | `/users/{user_id}/stores/search` | Searches stores by `external_id` or other available parameters; returns paginated results. |
| :TagComponent{tag="PUT" text="Update store" href="/developers/en/reference/in-person-payments/qr-code/stores/update-store/put" color="orange"} | `/users/{user_id}/stores/{id}` | Updates the configuration data of an existing store. |
| :TagComponent{tag="DELETE" text="Delete store" href="/developers/en/reference/in-person-payments/qr-code/stores/delete-store/delete" color="red"} | `/users/{user_id}/stores/{id}` | Deletes a store and unlinks it from its POS terminals. |

:::

:::AccordionComponent{title="POS terminals" pill="Core"}

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 |
|---|---|---|
| :TagComponent{tag="POST" text="Create POS" href="/developers/en/reference/in-person-payments/qr-code/pos/create-pos/post" color="green"} | `/pos` | Creates a POS in a store, generates the static QR Code, and allows defining the point of sale operating mode. |
| :TagComponent{tag="GET" text="Get POS" href="/developers/en/reference/in-person-payments/qr-code/pos/get-pos/get" color="accent"} | `/pos/{id}` | Returns the detail of a POS terminal, including the `qr_code` to display at the point of sale. |
| :TagComponent{tag="GET" text="Search POS terminals" href="/developers/en/reference/in-person-payments/qr-code/pos/search-pos/get" color="accent"} | `/pos` | Searches POS by `external_id` or other available parameters; returns paginated results. |
| :TagComponent{tag="PUT" text="Update POS" href="/developers/en/reference/in-person-payments/qr-code/pos/update-pos/put" color="orange"} | `/pos/{id}` | Updates the configuration of an existing POS terminal. |
| :TagComponent{tag="DELETE" text="Delete POS" href="/developers/en/reference/in-person-payments/qr-code/pos/delete-pos/delete" color="red"} | `/pos/{id}` | Deletes a POS terminal and its associated QR Code. |

:::

:::AccordionComponent{title="API Orders" pill="Core"}

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 |
|---|---|---|
| :TagComponent{tag="POST" text="Create order" href="/developers/en/reference/in-person-payments/qr-code/orders/create-order/post" color="green"} | `/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. |
| :TagComponent{tag="GET" text="Get order by ID" href="/developers/en/reference/in-person-payments/qr-code/orders/get-order/get" color="accent"} | `/v1/orders/{id}` | Returns the status and detail of an order, including the payment result. |
| :TagComponent{tag="POST" text="Refund an order" href="/developers/en/reference/in-person-payments/qr-code/orders/refund-order/post" color="green"} | `/v1/orders/{id}/refund` | Refunds a paid order, fully or partially. |
| :TagComponent{tag="POST" text="Cancel order by ID" href="/developers/en/reference/in-person-payments/qr-code/orders/cancel-order/post" color="green"} | `/v1/orders/{id}/cancel` | Cancels a pending order before it is paid by the customer. |

:::

:::AccordionComponent{title="Chargebacks" pill="Post-payment management"}

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Get chargeback" href="/developers/en/reference/in-person-payments/qr-code/get-chargeback/get" color="accent"} | `/v1/chargebacks/{id}` | Returns the detail of a chargeback: dispute status, affected amount, and deadline to respond. |

:::

---
product_landing_how_integrate:
 - title: All set to get started?
 - sub_title: Go to the first endpoint and start setting up your QR Code payment infrastructure.
 - button_description: Create store
 - button_link: /developers/en/reference/in-person-payments/qr-code/stores/create-store/post
---