SNAP Inquiry Static VA

This API is used to inquiry data of static VA transactions in SNAP standard for route payment.

URL Path

urlmerchant + /v1.0/transfer-va/inquiry

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 ParameterData TypeM/O/CDescription

partnerServiceId

String (8)

M

Derivative of X-PARTNER-ID, similar to company code,8 digit left padding space

customerNo

String (20)

M

Unique number (up to 20 digits).

virtualAccountNo

String (28)

M

partnerServiceId (8 digit left padding space) + customerNo (up to 20 digits)

inquiryRequestId

String (32)

M

Unique identifier for this Inquiry. Generated by Faspay.

Sample Request

{
    "partnerServiceId": "  88899",
    "customerNo": "12345678901234567890",
    "virtualAccountNo": "  08889912345678901234567890",
    "inquiryRequestId": "abcdef-123456-abcdef"
}

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 isare incorrect, the transaction will be rejected in the system Faspay.

SNAP ParameterData TypeM/O/CDescription

responseCode

String (7)

M

Response code. In details here.

responseMessage

String (150)

M

Response description. In details here.

virtualAccountData

Object

M

partnerServiceId

String (8)

M

Derivative of X-PARTNER-ID , similar to company code, 8 digit left padding space

customerNo

String (20)

M

Unique number (up to 20 digits)

virtualAccountNo

String (28)

M

partnerServiceId (8 digit left padding space) + customerNo (up to 20 digits)

virtualAccountName

String (128)

M

Customer name

virtualAccountEmail

String (128)

O

Customer email

virtualAccountPhone

String (30)

O

Customer's phone number. Format: 62xxxxxxxxxxxxx

inquiryRequestId

String (128)

M

From Inquiry Request

totalAmount

Object

M

value

String (ISO4217) (16,2)

M

Transaction Amount. Total Amount with 2 decimals

currency

String (3)

M

Currency

additional_info

Object

Additional Information for custom use

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": "2002400",
    "responseMessage": "Success",
    "virtualAccountData":
    {
        "partnerServiceId": "  088899",
        "customerNo": "12345678901234567890",
        "virtualAccountNo": "  08889912345678901234567890",
        "virtualAccountName": "Johnny Suh",
        "virtualAccountEmail": "johnnysuh@email.com",
        "virtualAccountPhone": "6281828384858",
        "inquiryRequestId": "abcdef-123456-abcdef",
        "totalAmount":
        {
            "value": "12345678.00",
            "currency": "IDR"
        },
        "additionalInfo":
        {
            "route":
            [
                {
                    "owner": "26100253"
                },
                {
                    "partnerId": "29195827",
                    "partnerAmount": "5000.00"
                },
                {
                    "partnerId": "aws-2",
                    "partnerAmount": "3000.00"
                }
            ]
        }
    }
}
PreviousInquiry Static VANextResponse Code

Last updated