Introduction

Dana is a payment method for payments and refunds in Indonesia.

Supported Countries

Indonesia

Supported Currencies

Payment (Deposit) Flow

Follow these steps to perform a payment using Nuvei REST API integration:

1. Generate a `sessionToken`

Press here for details.

2. Send a `/payment` Request

Perform the payment by sending a /payment request with its mandatory parameters including:

userTokenId
amount
currency
paymentOption.alternativePaymentMethod class containing:
- paymentMethod: “apmgw_Dana“
deviceDetails class containing: ipAddress
billingAddress class containing: firstName, lastName, email, phone, country
userDetails class containing: firstName, lastName, email, phone, country

Example `/payment` Request

{
  "sessionToken":"<sessionToken from /getSessionToken>",
  "merchantId":"<your merchantId>",
  "merchantSiteId":"<your merchantSiteId>",
  "clientRequestId":"<unique request ID in merchant system>",
  "amount":"1000",
  "currency":"IDR",
  "userTokenId":"<unique customer identifier in merchant system>",
  "clientUniqueId":"<unique transaction ID in merchant system>",
  "paymentOption":{
    "alternativePaymentMethod":{
      "paymentMethod":"apmgw_Dana"
    }
  },
  "deviceDetails":{
    "ipAddress":"<customer's IP address>"
  },
  "billingAddress":{
    "firstName":"John",
    "lastName":"Smith",
    "phone":"622442573903",
    "email":"[email protected]",
    "country":"ID"
  },
  "userDetails":{
    "firstName":"John",
    "lastName":"Smith",
    "phone":"622442573903",
    "email":"[email protected]",
    "country":"ID"
  },
  "timeStamp":"<YYYYMMDDHHmmss>",
  "checksum":"<calculated checksum>"
}

After the transaction is processed, Nuvei sends a Direct Merchant Notification (DMN) that includes the result of the transaction to the URL provided in urlDetails.notificationUrl, which Nuvei recommends including in the /payment request.

User Experience

The user is redirected to the Dana page to complete the transaction.
The user enters their phone number.
The user enters their PIN.
The user reviews the payment details and confirms the payment.
The user receives a message confirming the payment.
The user presses Close.
The user is redirected to the merchant ReturnUrl.