SNAP Create Virtual Account

This API is used to create virtual account 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

virtualAccountName

String (128)

M

Customer name

virtualAccountEmail

String (128)

O

Customer email

virtualAccountPhone

String (30)

O

Customer's phone number. Format: 62xxxxxxxxxxxxx

trxId

String (32)

M

Transaction ID in Partner system

totalAmount

Object

O

value

String (16,2)

M

Transaction Amount. Total Amount with 2 decimals

currency

String (3)

M

Currency = IDR

expiredDate

String (25)

O

Expiration date for Virtual Account. ISO-8601

additionalInfo

Object

O

Additional Information

billDate

Datetime (25)

M

Transaction/ Order Date. local time in yyyy-MM-ddTHH:mm:ssTZD format

channelCode

Numeric (32)

M

billDescription

String (18)

M

Bill description

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 Request

{
    "virtualAccountName": "Andi",
    "virtualAccountEmail": "andi@gmail.com",
    "virtualAccountPhone": "12345",
    "trxId": "7970999936312263",
    "totalAmount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "expiredDate": "2024-09-19T16:20:00+07:00",
    "additionalInfo": {
        "billDate": "2024-09-18T09:00:00+07:00",
        "channelCode": "708",
        "billDescription": "transaction",
        "route": [
            {
                "owner": "26100253"
            },
            {
                "partnerId": "29195827",
                "partnerAmount": "5000.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

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

trxId

String (32)

M

From create VA request

totalAmount

Object

O

value

String (ISO4217) (16,2)

M

Transaction amount. The total amount with 2 decimals.

currency

String (3)

M

Currency. Currency of amount based on ISO 4217.

expiredDate

String (25)

M

Expiration date for Virtual Account. ISO-8601

additionalInfo

Object

O

Additional Information for custom use

billDate

Datetime (25)

M

Transaction/ order date

channelCode

Numeric (32)

M

Payment channel code VA ONLY

billDescription

String (18)

M

Bill description

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.

redirectUrl

String

O

Merchant call back URL

Sample Response

{
    "responseCode": "2002700",
    "responseMessage": "Success",
    "virtualAccountData": {
        "partnerServiceId": "  338309",
        "customerNo": "25000598",
        "virtualAccountNo": "1726631925000598",
        "virtualAccountName": "Andi",
        "virtualAccountEmail": "andi@gmail.com",
        "virtualAccountPhone": "12345",
        "trxId": "7970999936312263",
        "totalAmount": {
            "value": "10000.00",
            "currency": "IDR"
        },
        "expiredDate": "2024-09-19T16:20:00+07:00",
        "additionalInfo": {
            "billDate": "2024-09-18T09:00:00+07:00",
            "channelCode": "708",
            "billDescription": "transaction",
            "route": [
                {
                    "owner": "26100253"
                },
                {
                    "partnerId": "29195827",
                    "partnerAmount": "5000.00"
                },
                {
                    "partnerId": "andre-121321346",
                    "partnerAmount": "5000.00"
                }
            ],
            "redirectUrl": "https://debit-sandbox.faspay.co.id/pws/100003/0830000010100000/d3cf14a84807d0d8240813243b26ee26de6e9739?trx_id=1726631925000598&merchant_id=99999&bill_no=7970999936312263"
        }
    }
}
PreviousSNAP Generate QRISNextSNAP Direct Debit

Last updated