# Send Person to Merchant API

> Send Person to Merchant API on Apizie: 15 endpoints (Initiates a Mastercard Merchant Presented QR purchase transaction by securing funds from a consumer’s…, Purpose of this service is to retrieve the Transfer resource associated with a specified transfer_reference…, Initiates a Mastercard Merchant Presented QR purchase transaction by pushing funds to a merchant account., Initiates a Mastercard Merchant Presented QR Refund transaction by pushing funds from a merchant account…, …) returned as clean JSON through one API key. 15 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:mastercard-masterpassqr`
- Category: Open Data
- Status: live
- Source: https://mastercard.com
- Page: https://zieapi.vercel.app/api/open-data/mastercard-masterpassqr
- OpenAPI: https://zieapi.vercel.app/api/open-data/mastercard-masterpassqr/openapi.json



## Endpoints

### Initiates a Mastercard Merchant Presented QR purchase transaction by securing funds from a consumer’s…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/create-merchant-transfer`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Type: Alphanumeric Special [a-zA-Z0-9_-], Length: 32 |
| body | object | yes | JSON request body |

### Purpose of this service is to retrieve the Transfer resource associated with a specified transfer_reference…
`GET https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/get-merchant-transfer-by-ref`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Details - string, 32 |
| ref | string | yes | Query Param - Is the client specified transfer reference when initiating the transfer. Allowable characters are alphanumeric and * , - . _… |

### Initiates a Mastercard Merchant Presented QR purchase transaction by pushing funds to a merchant account.
`POST https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/create-merchant-payment`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Details - string, 32 |
| body | object | no | JSON request body |

### Initiates a Mastercard Merchant Presented QR Refund transaction by pushing funds from a merchant account…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/create-merchant-refund`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Details - string, 32 |
| body | object | no | JSON request body |

### Purpose of this service is to retrieve the Transfer resource associated with the specified transfer-id.
`GET https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/get-merchant-transfer-by-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Details - string, 32 |
| transferId | string | yes | Path Param - Valid transfer id |

### Funding Reversals must be submitted within 30 minutes of the funding transfer request, and should only be…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/create-funding-reversal`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partner-id | string | yes | Path Param - Provider assigned partner id. Details - string, 32 |
| transfer-id | string | yes | Valid transfer id |
| transaction-id | string | yes | Valid transaction id |
| body | string | no | XML request body (string) |

### Client can simulate a Mastercard Merchant Presented QR Payment notification to the registered URL endpoint.
`POST https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/send-notification-payment-retry`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Details - string, 32 |
| body | string | no | XML request body (string) |

### Client can simulate a Mastercard Merchant Presented QR Refund notification to the registered URL endpoint.
`POST https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/send-notification-refund-retry`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Details - string, 32 |
| body | string | no | XML request body (string) |

### This service allows Mastercard Merchant QR originating and receiving partners to register a PAN and service…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/create-transfer-notification-registration`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Type: Alphanumeric Special Length: 40 |
| body | object | no | JSON request body |

### This service allows Mastercard Merchant QR originating and receiving partners to retrieve the service…
`GET https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/notification-registration-apiread-by`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Type: Alphanumeric Special Length: 40 |
| account-reg-ref | string | yes | Path Param - System generated unique account registration identifier. Type: Alphanumberic Special Length: 40 |

### This service allows Mastercard Merchant QR originating and receiving partners to update the notitification…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/notification-registration-apiupdate`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Type: Alphanumeric Special Length: 40 |
| account-reg-ref | string | yes | Path Param - System generated unique account registration identifier. Type: Alphanumeric Special Length: 40 |
| body | object | no | JSON request body |

### This service allows Mastercard Merchant QR originating and receiving partners to delete a registered PAN for…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/delete-transfer-notification-registration`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Type: Alphanumeric Special Length: 40 |
| account-reg-ref | string | yes | Path Param - System generated unique account registration identifier. Type: Alphanumeric Special Length: 40 |

### The Funding Transaction enables the 'pull' of money from the sender's card to the Transaction Originator who…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/create-funding`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Details - string, 32 |
| body | string | no | XML request body (string) |

### Used to create a digital account reference number from Incontrol
`POST https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/create-digital-accnt-ref-num`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Type: Alphanumeric Special [a-zA-Z0-9_-], Length: 32 |
| body | object | no | JSON request body |

### Used to retreive a digital account reference list from Incontrol
`POST https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/retrieve-digital-accnt-ref-num-list`

| Parameter | Type | Required | Description |
|---|---|---|---|
| partnerId | string | yes | Path Param - Provider assigned partner id. Details - string, 32 |
| body | object | no | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/create-merchant-transfer" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Send Person to Merchant API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/open-data:mastercard-masterpassqr/create-merchant-transfer with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Send Person to Merchant API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Send Person to Merchant API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:mastercard-masterpassqr.

### What is the status of the Send Person to Merchant API?
Live: works with just an Apizie key