# SNAP Generate QRIS

This API is used to Generate QRIS in SNAP standard for route payment.

<table data-header-hidden><thead><tr><th width="131"></th><th></th></tr></thead><tbody><tr><td><strong>URL Path</strong></td><td><a href="https://debit-sandbox.faspay.co.id/v1.0/qr/qr-mpm-generate">https://debit-sandbox.faspay.co.id/v1.0/qr/qr-mpm-generate</a></td></tr><tr><td><strong>Method</strong></td><td>POST</td></tr></tbody></table>

## Request Parameter

The parameters that must be provided by the Merchant system to be accessed by the Faspay system are as follows:

<table><thead><tr><th width="246">SNAP Parameter</th><th width="170">Data Type</th><th width="86">M/O/C</th><th>Description</th></tr></thead><tbody><tr><td>partnerReferenceNo</td><td>String(32)</td><td>M</td><td>Transaction identifier on service consumer system</td></tr><tr><td>amount</td><td>Object</td><td>M</td><td> An object that contains information about an amount or value within a specific context.</td></tr><tr><td>    value</td><td>String(16,2)</td><td>M</td><td>Net amount of the transaction. If it's IDR then value includes 2 decimal digits. e.g. IDR 10.000,- will be placed with 10000.00 with 2 decimal</td></tr><tr><td>    currency</td><td>String(3)</td><td>M</td><td>Currency (ISO4217)</td></tr><tr><td>merchantId</td><td>String(5)</td><td>M</td><td>Merchant identifier that is unique per each merchant</td></tr><tr><td>validityPeriod</td><td>String(25)</td><td>M</td><td>The time when the QRIS validis valid. ISO-8601</td></tr><tr><td>additionalInfo</td><td>Object</td><td>O</td><td>Additional information</td></tr><tr><td>    billDate</td><td>String (25)</td><td>M</td><td><p>Transaction/ Order Date.</p><p>ISO-8601</p></td></tr><tr><td>    billDescription</td><td>String (128)</td><td>M</td><td>Bill description</td></tr><tr><td>    channelCode</td><td>String (32)</td><td>M</td><td><p>Payment Channel Code</p><p> </p><p><strong>List Channel Code:</strong></p><p>715 Linkaja QRIS</p><p>711 ShopeePay QRIS</p></td></tr><tr><td>    phoneNo</td><td>String (30)</td><td>C</td><td><p>Customer Phone Number</p><p> </p><p><strong>Notes:</strong></p><p>Mandatory for payment channel OVO Tokenized</p></td></tr><tr><td>   route</td><td>Object</td><td> </td><td> </td></tr><tr><td>        owner</td><td>Alphanumeric (32) </td><td> </td><td><p>Registered partner id that owns/generates the transaction. </p><p> </p><p><strong>Notes:</strong></p><ul><li>1 transaction only can contain 1 owner. </li><li>If null, then the remaining transaction amount will belong to the merchant’s Sendme balance. </li></ul></td></tr><tr><td>       partnerId</td><td>Alphanumeric (32) </td><td> </td><td>Merchant partner id number.</td></tr><tr><td>       partnerAmount</td><td>Numeric (15) </td><td> </td><td>Disbursement amount to partner.  </td></tr></tbody></table>

### Sample Request

{% tabs %}
{% tab title="Sample Request" %}

```json
{
    "partnerReferenceNo": "2020102900000000000001",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "merchantId": "99999",
    "validityPeriod": "2024-09-19T12:08:56+07:00",
    "additionalInfo": {
        "billDate": "2024-09-18T10:08:56+07:00",
        "billDescription": "Payment #12345678",
        "channelCode": "711",
        "phoneNo": "089876543210",
        "route":[
        {
            "owner": "26100253"
        },
        {
            "partnerId": "29195827",
            "partnerAmount": "4000.00"
        },
        {
            "partnerId": "andre-121321346",
            "partnerAmount": "5000.00"
        }
    ]
    }
}

```

{% endtab %}
{% endtabs %}

## Response Parameter

Response parameters are parameters that will be delivered by Faspay system in response to the request that have been sent by the merchant system. If no parameters appropriate/value are incorrect, the transaction will be rejected in the system Faspay.

<table><thead><tr><th width="284">SNAP Parameter</th><th width="142">Data Type</th><th width="96">M/O/C</th><th>Description</th></tr></thead><tbody><tr><td>responseCode</td><td>String (7)</td><td>M</td><td>Response code. In details <a href="response-code">here</a></td></tr><tr><td>responseMessage</td><td>String (150)</td><td>M</td><td>Response description. In details <a href="response-code">here</a></td></tr><tr><td>referenceNo</td><td>String (16)</td><td>M</td><td>Transaction identifier on service provider system. Must be filled upon successful transaction</td></tr><tr><td>partnerReferenceNo</td><td>String (32)</td><td>M</td><td>Transaction identifier on service consumer system</td></tr><tr><td>qrContent</td><td>String (512)</td><td>C</td><td>QR String MPM. Will be returned only for direct merchant. boi_oky=direct.</td></tr><tr><td>qrUrl</td><td>String (256)</td><td>C</td><td><p>QR URL for</p><p>download QR</p><p>Image</p><p> </p><p>Will be returned</p><p>only for direct</p><p>merchant.</p><p>boi_oky=direct.</p></td></tr><tr><td>additionalInfo</td><td>Object</td><td>O</td><td>Additional information</td></tr><tr><td>    qrImageUrl</td><td>String (256)</td><td>M</td><td><p>Redirect URL to display QR Image</p><p>in Faspay page</p><p> </p><p>Will not be returned for direct merchant. boi_oky=direct.</p></td></tr><tr><td>    merchantId</td><td>String (5)</td><td>M</td><td>Merchant identifier that is unique per each merchant</td></tr><tr><td>    nmid</td><td>String (15)</td><td>M</td><td>National Merchant Identification</td></tr><tr><td>    amount</td><td>Object</td><td>M</td><td>An object that contains information about an amount or value within a specific context.</td></tr><tr><td>         value</td><td>String (16,2)</td><td>M</td><td>Net amount of the transaction. If it's IDR then value includes 2 decimal digits. e.g. IDR 10.000,- will be placed with 10000.00 with 2 decimal</td></tr><tr><td>        currency</td><td>String (3)</td><td>M</td><td>Currency (ISO4217)</td></tr><tr><td>   phoneNo</td><td>String (30)</td><td>C</td><td><p>Customer Phone Number</p><p></p><p><strong>Notes:</strong></p><p>Mandatory for payment channel OVO Tokenized</p></td></tr><tr><td>   route</td><td>Object</td><td>O</td><td> </td></tr><tr><td>      owner</td><td>Alphanumeric (32) </td><td>O</td><td><p>Registered partner id that owns/generates the transaction. </p><p> </p><p><strong>Notes:</strong></p><ul><li> 1 transaction only can contain 1 owner. </li><li>If null, then the remaining transaction amount will belong to the merchant’s Sendme balance. </li></ul></td></tr><tr><td>      partnerId</td><td>Alphanumeric (32) </td><td>O</td><td>Merchant partner id number.</td></tr><tr><td>      partnerAmount</td><td>Numeric (15) </td><td>C</td><td>Disbursement amount to partner.  </td></tr></tbody></table>

### Sample Response

{% tabs %}
{% tab title="Response Sample" %}

```json
{
    "responseCode": "2004700",
    "responseMessage": "Request has been processed successfully",
    "referenceNo": "1999971121447888",
    "partnerReferenceNo": "2020102900000000000001",
    "qrContent": "00020101021226560016ID.CO.SHOPEE.WWW011893600918000000026602032660303UBE520412345303360540810000.005802ID5912Faspay Store6015KOTA JAKARTA SE610512345622805241999971121447888-145290163043A7C",
    "qrUrl": "https://debit-sandbox.faspay.co.id/__assets/qr/99999-1999971121447888.png",
    "additionalInfo": {
        "qrImageUrl": "https://debit-sandbox.faspay.co.id/pws/100003/0830000010100000/a32c3d417ec84d6e977484ab02192d26fd58563a?trx_id=1999971121447888&merchant_id=99999&bill_no=2020102900000000000001",
        "merchantId": "99999",
        "nmid": "ID2022149621171",
        "amount": {
            "value": "10000.00",
            "currency": "IDR"
        },
        "phoneNo": "089876543210",
        "route": [
            {
                "owner": "26100253"
            },
            {
                "partnerId": "29195827",
                "partnerAmount": "4000.00"
            },
            {
                "partnerId": "andre-121321346",
                "partnerAmount": "5000.00"
            }
        ]
    }
}

```

{% endtab %}
{% endtabs %}