Notification - API Payout (Disbursement) SNAP
This API with SNAP standards uses to send the notification from Payout or Disbursement proses result.
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+
API Endpoint | [merchant-domain]/api/v1.0/transfer/notify |
---|---|
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 | Tipe | Kebutuhan | Deskripsi |
---|---|---|---|
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 |
---|---|---|---|---|
originalPartnerReferenc eNo | String | 40 | Mandatory | Original transaction identifier on consumer system |
originalReferenceNo | String | 40 | Mandatory | Original transaction identifier on service provider system |
latestTransactionStatus | String | 2 | Mandatory | Category code for the status of the transaction. Example : 00- Success 03- Pending 09- Failed |
transactionStatusDesc | Object | 50 | Optional | Description status transaction |
beneficiaryBankCode | String | 4 | Mandatory | Beneficiary Bank Code - API SNAP |
beneficiaryAccountNo | String | 25 | Mandatory | Beneficiary Account Number |
beneficiaryName | String | 100 | Mandatory | Beneficiary Name |
amount | Object | Variable | Mandatory | Amount of transaction |
value | String | 12 | Mandatory | Value |
currency | String | 3 | Mandatory | Currency |
transactionDateTime | String | 25 | Optional | Transaction Date Using ISO-8601 Format YYYY-MM-DDTHH:MM:SS |
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 | | |