---
title: Cancel & Remove - DANA Recurring API
slug: en/nicepay-api-non-snap-cancel-and-remove-dana-recurring-e-wallet-advance-api
description: Information about Non-SNAP Advance API - E-Wallet DANA Cancel & Remove available on NICEPAY system
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/tdNBLIUWksnehPtQKJWNU_nicepay-docs-logo.png
icon: {"faIcon":"fa-solid fa-recycle"}
docTags: 
createdAt: 2025-05-19T08:45:41.370Z
---

# About Cancel & Remove - DANA Recurring API

***

This API is used to cancel a succesful transaction payment and remove the transaction data for the next payment. If the transaction cancellation occurs before the Settlement process completed, then that transaction is considered void and the transaction funds will be refunded to Customer.



# 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

***

The following are the list of parameters when requesting for cancellation during E-Wallet DANA Recurring transaction process.

| **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\:IifMsRUUw7j9VMWeFJz97)  | `05`: E-Wallet                                                                                       |
| `cancelType`<br /><font color="#2166ae">Required</font>    | N        | 2          | [Cancel Type Code](docId\:puGgd4_zFLoaF97OaDv07)     | `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                                       | 1000                                                                                                 |
| `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

***

The following are the list of cancellation response during E-Wallet DANA Recurring transaction process.

| **Parameter** | **Tipe** | **Ukuran** | **Deskripsi**                               | **Contoh / Catatan**                                      |
| ------------- | -------- | ---------- | ------------------------------------------- | --------------------------------------------------------- |
| `tXid`        | AN       | 30         | Transaction ID                              | IONPAYTEST02201603091207051498<br />When Success          |
| `referenceNo` | ANS      | 40         | Merchant Order No.                          | OrdNo20160525000-52104<br />When Success                  |
| `resultCd`    | N        | 4          | [Result Code](docId:7o8Nl7guqp_asiwFdqi3v)  | 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                                      | 1000<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"
}
```
:::