SNAP Create Virtual Account
Last updated
Last updated
This API is used to create virtual account in SNAP standard for route payment.
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 |
---|---|---|---|
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 is incorrect, the transaction will be rejected in the system Faspay.
SNAP Parameter | Data Type | M/O/C | Description |
---|---|---|---|
URL Path
Method
POST
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
Payment Channel Code VA ONLY refer to here.
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.
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
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