---
title: Cancel & Remove - DANA Recurring API
slug: nicepay-api-non-snap-cancel-and-remove-dana-recurring-e-wallet-advance-api
description: Informasi tentang API Non-SNAP Advance API - E-Wallet DANA Recurring Cancel & Remove yang terdapat pada sistem NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/3Me3MkIpPHMWNuMNb-GG7_nicepay-docs-logo.png
icon: {"faIcon":"fa-solid fa-recycle"}
docTags: 
createdAt: 2024-05-06T03:36:51.701Z
---

# Tentang Cancel & Remove - DANA Recurring API

***

API ini digunakan untuk membatalkan transaksi yang sudah dibayarkan dan menghapus data transaksi untuk pembayaran selanjutnya. Jika transaksi dibatalkan sebelum proses Settlement selesai, maka transaksi tersebut dianggap *void *dan dana transaksi tersebut akan dikembalikan kepada Pelanggan.



# Cancel & Remove - DANA Recurring API

***

| **API Endpoint**   | `/nicepay/direct/v2/cancel`                           |
| ------------------ | ----------------------------------------------------- |
| **Request Method** | ****<font color="#3b9f0f">**POST**</font>**, JSON**   |
| **Description**    | Cancel API&#xD;                                       |
| **Merchant Token** | SHA256(`timeStamp`+`iMid`+`tXid`+`amt`+`merchantKey`) |



## Request Parameter Cancel & Remove - DANA Recurring

***

Berikut ini adalah daftar parameter untuk melakukan *request&#x20;*&#x70;embatalan pada proses transaksi DANA Recurring E-Wallet.&#x20;

| **Parameter**                                              | **Tipe** | **Ukuran** | **Deskripsi**                                        | **Contoh / Catatan**                                                                                 |
| ---------------------------------------------------------- | -------- | ---------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| `timeStamp`<br /><font color="#2166ae">Required</font>     | N        | 14         | API Request Date                                     | 20170708123456                                                                                       |
| `tXid`<br /><font color="#2166ae">Required</font>          | AN       | 30         | Transaction ID                                       | IONPAYTEST02201603091207051498                                                                       |
| `iMid`<br /><font color="#2166ae">Required</font>          | AN       | 10         | Merchant ID                                          | IONPAYTEST                                                                                           |
| `payMethod`<br /><font color="#2166ae">Required</font>     | N        | 2          | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok)  | `05`: E-Wallet                                                                                       |
| `cancelType`<br /><font color="#2166ae">Required</font>    | N        | 2          | [Cancel Type Code](docId\:Mq9xE7wdOPR8OkZ3v-pVc)     | `1`: Full Cancellation<br />`2`: Partial Cancellation<br />`3`: Remove Subscription / Stop Recurring |
| `cancelMsg`<br />                                          | AN       | 255        | Cancel Message                                       | Cancel Message                                                                                       |
| `merchantToken`<br /><font color="#2166ae">Required</font> | AN       | 255        | Merchant Token                                       | 6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd                                     |
| `amt`<br /><font color="#2166ae">Required</font>           | N        | 12         | Payment Amount                                       | 100                                                                                                  |
| `cancelServerIp`                                           | AN       | 15         | Server IP                                            | 127.0.0.1                                                                                            |
| `cancelUserId`                                             | AN       | 30         | User ID                                              | Admin                                                                                                |
| `cancelUserIp`                                             | AN       | 15         | User IP                                              | 127.0.0.1                                                                                            |
| `cancelUserInfo`                                           | AN       | 100        | User Information                                     | Customer cancel transaction                                                                          |
| `cancelRetryCnt`                                           | N        | 2          | Retry Count                                          | (Optional)                                                                                           |
| `worker`                                                   | AN       | 10         | Worker                                               | Worker                                                                                               |



## Response Parameter Cancel & Remove - DANA Recurring

***

Berikut ini adalah daftar *response* dari pembatalan pada proses transaksi E-Wallet DANA Recurring.&#x20;

| **Parameter** | **Tipe** | **Ukuran** | **Deskripsi**                                | **Contoh / Catatan**                                      |
| ------------- | -------- | ---------- | -------------------------------------------- | --------------------------------------------------------- |
| `tXid`        | AN       | 30         | Transaction ID                               | IONPAYTEST02201603091207051498<br />When Success          |
| `referenceNo` | ANS      | 40         | Merchant Order Number                        | OrdNo20160525000-52104<br />When Success                  |
| `resultCd`    | N        | 4          | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM)  | 0000                                                      |
| `resultMsg`   | AN       | 255        | Result Message                               | SUCCESS                                                   |
| `transDt`     | N        | 8          | Transaction Date                             | 20160303<br /><br />When Success                          |
| `transTm`     | N        | 6          | Transaction Time                             | 135959<br /><br />When Success                            |
| `description` | AN       | 255        | Description                                  | Payment of OrdNo20160525000-52104<br /><br />When Success |
| `amt`         | N        | 12         | Amount                                       | 100<br /><br />When Success                               |



## Sample Parameter Cancel & Remove - DANA Recurring

***

:::CodeblockTabs
Sample Request Cancel

```json
{
    "timeStamp": "20211203091223",
    "tXid": "IONPAYTEST05202108231310459282",
    "iMid": "IONPAYTEST",
    "payMethod": "05",
    "cancelType": "1",
    "cancelMsg": "Full Cancel",
    "merchantToken": "654100834b5c4174235e831941d4d2524949e4e44f1102cb45b9ccefa96c1629",
    "preauthToken": "",
    "amt": "100",
    "cancelServerIp": "",
    "cancelUserId": "",
    "cancelUserIp": "",
    "cancelUserInfo": "",
    "cancelRetryCnt": "",
    "worker": ""
}
```

Sample Response Cancel

```json
{
    "tXid": "IONPAYTEST05202108231310459282",
    "referenceNo": " OrdNo20217131024122",
    "resultCd": "0000",
    "resultMsg": "SUCCESS",
    "transDt": "20210823",
    "transTm": "131250",
    "description": " this is test transaction!!",
    "amt": "1000"
}
```

Sample Request Remove

```json
{
    "timeStamp": "20211203091208",
    "tXid": "IONPAYTEST05202108231310459282",
    "iMid": "IONPAYTEST",
    "payMethod": "05",
    "cancelType": "3",
    "cancelMsg": "Test Remove Recurring",
    "merchantToken": "5bb6dac991d5529745f95dfbd1b6ddc75152a0231da303b77d148d63d46011df",
    "preauthToken": "",
    "amt": "100",
    "cancelServerIp": "",
    "cancelUserId": "",
    "cancelUserIp": "",
    "cancelUserInfo": "",
    "cancelRetryCnt": "",
    "worker": ""
}
```

Sample Response Remove

```json
{
    "tXid": "IONPAYTEST05202108231310459282",
    "referenceNo": " OrdNo20217131024122",
    "resultCd": "0000",
    "resultMsg": "SUCCESS",
    "transDt": "20210823",
    "transTm": "131250",
    "description": " this is test transaction!!",
    "amt": "100"
}
```
:::