---
title: Payment - API Direct Debit
slug: en/nicepay-api-non-snap-payment-api-direct-debit
description: Information about Non-SNAP Payment API - Payment - Direct Debit API available on NICEPAY system
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/1Rc62YsBz6yIH-mF1MlBx_microsoftteams-image.png
icon: {"faIcon":"fa-solid fa-book"}
docTags: 
createdAt: 2022-12-01T07:41:29.000Z
---

# About API Direct Debit Payment 

***

Through Direct Debit payment method, NICEPAY offers you the convenience of cross application payments (Jump App) for your Customers. Notifications will be sent to Customers in real time as soon as Customers complete payment.

:::hint{type="info"}
- Please visit the [Direct Debit Payment Flow](docId\:hmEoZZ2tXYJlvN-jyzpJ3) page to aknowledge the Direct Debit payment flow through Jenius Pay.
- Please visit the [Direct Debit](docId\:uNFXkAwzKTCzlss__2PUt) page to learn general information about Direct Debit payment method.
:::



# API Direct Debit Payment 

***

Direct Debit Payment aims to activate the Direct Debit payment method at Merchant, so that Customer can make payment transactions using Direct Debit with Merchants. This stage is to integrate the Merchant system with the NICEPAY system.





| **API Endpoint**   | `/nicepay/direct/v2/payment`                                 |
| ------------------ | ------------------------------------------------------------ |
| **Request Method** | <font color="#3b9f0f">**POP UP, Redirect, Submit**</font>    |
| **Description**    | Performs Payment Request to NICEPAY&#xD;                     |
| **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) |
| **Request Format** | `application/x-www-form-urlencoded
`                         |

:::hint{type="success"}
Payment process can only be carried out after completing the registration process. For more detailed information regarding registration, please refer to the [Registration - API Direct Debit](docId\:yfZlLpmX5PMjgr6-qcMAj)  page.
:::



## Request Parameter for Direct Debit Payment

***

The following is a list of parameters for requesting the registration of Direct Debit payment method through Jenius Pay. This parameter is used through the API testing platform as one of the stages so that the Merchant's system can connect with services from NICEPAY.

| **Parameter**                                              | **Type** | **Length** | **Description**                         | **Example / Notes**                                              |
| ---------------------------------------------------------- | -------- | ---------- | --------------------------------------- | ---------------------------------------------------------------- |
| `timeStamp`<br /><font color="#2166ae">Required</font>     | N        | 14         | Request Timestamp (`YYYYMMDDHH24MISS`)	 | 20250307130363                                                   |
| `tXid`<br /><font color="#2166ae">Required</font>          | AN       | 30         | Transaction ID	                         | TNICECP04104202503071335233256                                   |
| `referenceNo`<br /><font color="#2166ae">Required</font>   | ANS      | 40         | Merchant's Reference Number             | ORD20250307130386                                                |
| `callBackUrl`<br /><font color="#2166ae">Required</font>   | ANS      | 255        | Payment Result URL                      | https\://dev.nicepay.co.id/IONPAY\_CLIENT/paymentResult.jsp      |
| `cashtag`<br /><font color="#2166ae">Required</font>       | A        | 100        | Cashtag ID (with $)                     | $johndoe                                                         |
| `merchantToken`<br /><font color="#2166ae">Required</font> | AN       | 255        | Merchant Token                          | 8cff7e7cf660fee8afe26b04678b5c16ad63cd2697ede06bab4efbc9357b960a |

:::hint{type="success"}
You can follows the Direct Debit integration and testing through Jenius Pay guidance in the [Direct Debit Integration & Testing](docId:9lg6VXg1smiFZr4nQi1-f) page.
:::



## Response Parameter for Direct Debit Payment&#x20;

***

| **Parameter** | **Tipe** | **Ukuran** | **Deskripsi**                                              | **Contoh / Catatan**                |
| ------------- | -------- | ---------- | ---------------------------------------------------------- | ----------------------------------- |
| `resultCd`    | N        | 4          | [Result Code](docId:7o8Nl7guqp_asiwFdqi3v)                 | 0000                                |
| `resultMsg`   | AN       | 225        | Result Message: [Error Code](docId\:wpcEMaZro_Xvnxz-1ZAiB) | Success                             |
| `tXid`        | AN       | 30         | Transaction ID<br />                                       | &#xD;TNICECP04104202503061526463653 |
| `referenceNo` | ANS      | 40         | Merchant's Reference Number                                | OrdNo-20250306150301                |
| `amt`         | N        | 12         | Amount                                                     | 10000                               |
| `transDt`     | N        | 8          | Transaction Date (`YYYYMMDD`)                              | 20250306                            |
| `transTm`     | N        | 6          | Transaction Date (`HH24MISS`)                              | 152646                              |


Sample JSON for Direct Debit Payment
------------------------------------

***

:::CodeblockTabs
Request Parameter

```json
{
"timeStamp": "20250307130363",
"tXid": "TNICECP04104202503071335233256",
"referenceNo": "ORD20250307130386",
"callBackUrl": "https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp",
"cashtag": "$johndoe",
"merchantToken": "8cff7e7cf660fee8afe26b04678b5c16ad63cd2697ede06bab4efbc9357b960a"
}
```

Response Parameter

```json
{
"resultCd": "0000",
"resultMsg": "Please do payment on jenius pay apps",
"tXid": "TNICECP04104202503061526463653",
"referenceNo": "OrdNo-20250306150301",
"amt": "",
"transDt": "20250306",
"transTm": "152646"
}
```
:::