SNAP Generate QRIS

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

URL Path

Method

POST

Request Parameter

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

SNAP Parameter
Data Type
M/O/C
Description

partnerReferenceNo

String(32)

M

Transaction identifier on service consumer system

amount

Object

M

An object that contains information about an amount or value within a specific context.

value

String(16,2)

M

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

currency

String(3)

M

Currency (ISO4217)

merchantId

String(5)

M

Merchant identifier that is unique per each merchant

validityPeriod

String(25)

M

The time when the QRIS validis valid. ISO-8601

additionalInfo

Object

O

Additional information

billDate

String (25)

M

Transaction/ Order Date.

ISO-8601

billDescription

String (128)

M

Bill description

channelCode

String (32)

M

Payment Channel Code

List Channel Code:

715 Linkaja QRIS

711 ShopeePay QRIS

phoneNo

String (30)

C

Customer Phone Number

Notes:

Mandatory for payment channel OVO Tokenized

route

Object

owner

Alphanumeric (32)

Registered partner id that owns/generates the transaction.

Notes:

  • 1 transaction only can contain 1 owner.

  • If null, then the remaining transaction amount will belong to the merchant’s Sendme balance.

partnerId

Alphanumeric (32)

Merchant partner id number.

partnerAmount

Numeric (15)

Disbursement amount to partner.

Sample Request

{
    "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"
        }
    ]
    }
}

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.

SNAP Parameter
Data Type
M/O/C
Description

responseCode

String (7)

M

responseMessage

String (150)

M

referenceNo

String (16)

M

Transaction identifier on service provider system. Must be filled upon successful transaction

partnerReferenceNo

String (32)

M

Transaction identifier on service consumer system

qrContent

String (512)

C

QR String MPM. Will be returned only for direct merchant. boi_oky=direct.

qrUrl

String (256)

C

QR URL for

download QR

Image

Will be returned

only for direct

merchant.

boi_oky=direct.

additionalInfo

Object

O

Additional information

qrImageUrl

String (256)

M

Redirect URL to display QR Image

in Faspay page

Will not be returned for direct merchant. boi_oky=direct.

merchantId

String (5)

M

Merchant identifier that is unique per each merchant

nmid

String (15)

M

National Merchant Identification

amount

Object

M

An object that contains information about an amount or value within a specific context.

value

String (16,2)

M

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

currency

String (3)

M

Currency (ISO4217)

phoneNo

String (30)

C

Customer Phone Number

Notes:

Mandatory for payment channel OVO Tokenized

route

Object

O

owner

Alphanumeric (32)

O

Registered partner id that owns/generates the transaction.

Notes:

  • 1 transaction only can contain 1 owner.

  • If null, then the remaining transaction amount will belong to the merchant’s Sendme balance.

partnerId

Alphanumeric (32)

O

Merchant partner id number.

partnerAmount

Numeric (15)

C

Disbursement amount to partner.

Sample Response

{
    "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"
            }
        ]
    }
}

Last updated