Notification - API Virtual Account SNAP
This API with the SNAP standards uses to send the payment transaction notification on the Virtual Account payment method.
The following is guidance to proceed X-SIGNATURE validation on Request Header Notify:
SHA256withRSA (Public_Key, stringToSign) stringToSign = client_ID + “|” + X-TIMESTAMP
The following is the example of X-SIGNATURE result from the above guidance validation"
mYyscWBs00bm0TJQ/xY7Uu1Goh8qXJyYSlo88rFrhQ+mlyQkMtq NKMlZDpS+
Service Code | 25 |
API Endpoint | [merchant-domain]/api/v1.0/transfer-va/payment |
HTTP Method | POST |
Content-type | application/json |
Description | Transaction Result Notification (when success) If your system use firewall, add allow policy for NICEPAY IP 103.20.51.0/24 103.117.8.0/24 |
Parameter | Type | Required | Description |
Content-Type | String | Mandatory | Application / JSON |
X-TIMESTAMP | String | Mandatory | Using ISO 8601 as timestamp format. Transaction date time, in format YYYYMMDDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time). 2022-03-21T10:11:40+07:00. |
X-CLIENT-KEY | String | Mandatory | Unique Partner ID, Partner ID = Client ID |
X-SIGNATURE | String | Mandatory | Request message signature (85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5) |
Parameter | Type | Length | Required | Description |
partnerServiceId | String | 20 | Mandatory | Partner Service ID / Prefix |
customerNo | String | 40 | Mandatory | Customer Number |
virtualAccountNo | String | 16 | Mandatory | Virtual Account Number |
virtualAccountName | String | 100 | Mandatory | Virtual Account Name |
trxId | String | 40 | Mandatory | Transaction ID (Reference Number from Merchant) |
paymentRequestId | String | 128 | Mandatory | Unique Identifier from NICEPAY |
paidAmount | Object | Variable | Mandatory | Amount of paid |
value | String | 12 | Mandatory | Value |
currency | String | 3 | Mandatory | Currency |
trxDateTime | String | 25 | Mandatory | Transaction Date Time |
additionalInfo | Object | Variable | Mandatory | Additional information |
bankCd | String | 4 | Mandatory | |
goodsNm | String | 200 | Mandatory | Goods Name |
vacctValidDt | String | 8 | Mandatory | Virtual Account Valid Date |
vacctValidTm | String | 6 | Mandatory | Virtual Account Valid Time |
Parameter | Type | Required | Description |
Content-Type | String | Mandatory | Application / JSON |
X-TIMESTAMP | String | Mandatory | Using ISO 8601 as timestamp format. Transaction date time, in format YYYYMMDDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time). 2022-03-21T10:11:40+07:00. |
Parameter | Type | Length | Required | Description |
responseCode | String | 7 | Mandatory | |
responseMessage | String | 150 | Mandatory | Response Message |
virtualAccountData | Object | Variable | Mandatory | Virtual Account Data |
partnerServiceId | String | 20 | Mandatory | Partner Service ID / Prefix |
customerNo | String | 40 | Mandatory | Customer Number |
virtualAccountNo | String | 16 | Optional | Virtual Account Number |
virtualAccountName | Object | 100 | Mandatory | Virtual Account Name |
trxId | Object | 40 | Mandatory | Merchant Reference Number |
paymentRequestId | String | 128 | Mandatory | Unique Identifier from NICEPAY |
paidAmount | Object | Variable | Mandatory | Amount of paid |
value | Object | 12 | Mandatory | Value |
currency | String | 3 | Mandatory | Currency |
trxDateTime | String | 25 | Mandatory | Transaction Date Time |
additionalInfo | Object | Variable | Mandatory | Additional information |
bankCd | String | 4 | Mandatory | |
goodsNm | String | 200 | Mandatory | Goods Name |