--- title: Notification Transaction - API E-Wallet (Direct Debit) SNAP slug: en/nicepay-api-snap-notification-e-wallet-direct-debit description: Information about Notification Transaction - API E-Wallet (Direct Debit) SNAP available on the NICEPAY system image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/fBPZAP3FMjoKgA5qHDZqa_microsoftteams-image.png icon: {"faIcon":"fa-solid fa-book"} docTags: createdAt: 2023-05-04T03:16:42.000Z --- # About Notification Transaction - API E-Wallet (Direct Debit) SNAP *** This API uses to send payment transaction notifications on the E-Wallet payment method with Direct Debit Host to Host Feature based on the SNAP standard. # X-SIGNATURE Guidance Validation *** The following is guidance to proceed X-SIGNATURE validation on Request Header Notify: `SHA256withRSA (Public_Key, stringToSign) stringToSign = client_ID + “|” + X-TIMESTAMP` :::hint{type="warning"} Information specific to the SNAP Notification API regarding the `Public_Key` will be provided by the NICEPAY team to the Merchant via email, because the `Public_Key` credential used in the SNAP Notification API is different from the SNAP Transaction API (Registration, Inquiry & Payment). Please contact the Integration team through email ([integration@nicepay.co.id](mailto\:integration@nicepay.co.id)) for further information or assistance. ::: The following is the example of X-SIGNATURE result from the above guidance validation" `mYyscWBs00bm0TJQ/xY7Uu1Goh8qXJyYSlo88rFrhQ+mlyQkMtq NKMlZDpS+` # Merchant Notification - API E-Wallet (Direct Debit) SNAP *** | **Service Code** | `56` | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **API Endpoint** | `[merchant-domain]/api/v1.0/debit/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 =
IP Public environtment Production:
`103.20.51.34`
`103.20.51.33`
`18.98.96.50`

IP Public environtment Dev:
`103.20.51.39`
`103.20.51.40`
`18.98.96.54` | ## Request Header Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP *** | **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 | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | ## Request Body Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Type** | **Length** | **Required** | **Description** | | ---------------------------- | -------- | ---------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `originalReferenceNo` | String | 40 | Mandatory | Original transaction identifier on service
provider system | | `originalPartnerReferenceNo` | String | 40 | Mandatory | Original transaction identifier on consumer
system | | `externalStoreId` | String | 32 | Optional | Unique identifier of shop id in client system | | `amount` | Object | Variable | Mandatory | Amount of transaction | | `value` | String | 12 | Mandatory | Value | | `currency` | String | 3 | Mandatory | Currency | | `latestTransactionStatus` | String | 2 | Mandatory | Category code for the status of the
transaction. Example :
`00`- Success
`06`- Failed | | `transactionStatusDesc` | String | 50 | Optional | Description status transaction | | `additionalInfo` | Object | Variable | Mandatory | Additional information | | `transactionDateTime` | String | 25 | Optional | Transaction Date Using ISO-8601 Format
`YYYY-MM-DDTHH:MM:SS` | | `mitraCd` | String | 4 | Mandatory | [Mitra Code - API SNAP](docId:6Go07oWr-B22bafUEtehl)

Example :
OVO : `OVOE`
Link Aja : `LINK`
DANA : `DANA`
ShopeePay : `ESHP` | | `goodsNm` | String | 200 | Mandatory | Goods Name | | `billingNm` | String | 100 | Mandatory | Buyer Name | | `billingPhone` | String | 20 | Mandatory | Buyer Phone Number | ## Response Header Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP *** | **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`.
| ## Response Body Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Type** | **Length** | **Required** | **Description** | | ----------------- | -------- | ---------- | ------------ | ---------------------------------------------------------------------------- | | `responseCode` | String | 7 | Mandatory | [General Response Code and Message - API SNAP](docId\:bJr4kjAmZCKnlN-5zRnvW) | | `responseMessage` | String | 150 | Mandatory | Response Message | ## Sample Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ 'https://merchant.com/api/v1.0/debit/notify' \ -H 'Content-type: application/json' \ -H 'X-TIMESTAMP: 2023-11-23T07:44:11+07:00' \ -H 'X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5' \ -H 'X-CLIENT-KEY: 82150823919040624621823174737537' \ -d '{"originalPartnerReferenceNo":"2020102977770000000009","originalReferenceNo":"TNICEEW05108202210141451109841","amount":{"value":"10000.00","currency":"IDR"},"latestTransactionStatus":"00","transactionStatusDesc":"Success","externalStoreId":"91863213913112","additionalInfo":{"transactionDateTime":"2019-07-03T12:08:56-07:00","mitra_cd":"DANA","goodsNm":"Merchant Goods 1","billingNm":"Buyer Name","billingPhone":"02112345678"}}' ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2005600", "responseMessage": "Success" } ``` :::