DANA

DANA is a digital wallet in Indonesia and part of the Alipay+ network. Customers pay for online purchases from their DANA balance or linked accounts. Payrails processes DANA through Checkout.com.

How a DANA payment works

DANA is a wallet redirect payment method:

The customer selects DANA at checkout.
Payrails creates the payment at Checkout.com and returns a redirect URL, and the customer goes to DANA.
The customer signs in to DANA and confirms the payment.
DANA sends the customer back to your returnInfo URL.
Payrails receives the final result from Checkout.com and updates the payment.

Each payment is single-use: the customer confirms every payment on its own. Payrails captures DANA payments immediately, so a successful payment is final. To return funds, refund the payment.

Supported currencies and countries

DANA supports IDR (Indonesian rupiah) as its presentment currency.

Supported workflows

Before you begin

Complete these steps before you send your first DANA payment through Checkout.com:

Set up a Checkout.com integration in your workspace. Follow the Checkout.com integration setup guide if you don’t have one yet.
Ask Checkout.com support to enable Alipay+ and DANA on your Checkout.com processing channel.
In the Payrails Portal, go to Settings → Integrations, open your Checkout.com integration, select Dana under Payment methods, and save.
Add DANA as a payment option in your workflow.

Request fields for Checkout.com

Send these fields in the authorize request, in addition to the standard authorize fields. Payrails checks Required fields and returns an error when one is missing. Fields required by the PSP pass the Payrails checks but the PSP can decline the payment without them.

Field	Status	Description
`meta.order.lines`	Required	At least one line item. Payrails sends line items to Checkout.com and skips tax and discount lines.
`meta.order.lines[].name`	Required	The item name.
`meta.order.lines[].id`	Required	Sent to Checkout.com as the item reference.
`meta.order.lines[].unitPrice`	Required	The price of one unit.
`meta.order.lines[].quantity`	Required	At least `1`.
`meta.order.lines[].totalDiscount`	Optional	Sent to Checkout.com as the item discount.
`meta.order.description`	Optional	Sent to Checkout.com as the payment description.
`meta.clientContext.clientType`	Optional	The customer’s device context: `web`, `app` or `wap`. Payrails sends `web` when you leave it out.
`meta.clientContext.osType`	Optional	`ios` or `android`, for app payments.
`meta.customer.name`, `meta.customer.lastName`	Optional	Sent to Checkout.com as the customer name.
`meta.customer.email`	Optional	Sent to Checkout.com as the customer email.

Authorize a DANA payment

Call authorize a payment with dana as the paymentMethodCode. The response includes the redirect to DANA.

Authorize request

{
  "amount": {
    "value": "150000.00",
    "currency": "IDR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "dana",
      "amount": {
        "value": "150000.00",
        "currency": "IDR"
      }
    }
  ],
  "meta": {
    "clientContext": {
      "clientType": "web"
    },
    "customer": {
      "email": "putri.santoso@example.com",
      "name": "Putri",
      "lastName": "Santoso"
    },
    "order": {
      "description": "Order 1234",
      "lines": [
        {
          "id": "item-001",
          "name": "Batik shirt",
          "quantity": 1,
          "unitPrice": {
            "value": "150000.00",
            "currency": "IDR"
          }
        }
      ]
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

After the customer confirms the payment, DANA returns them to your success or error URL. Confirm the result through webhook notifications or the execution status before you fulfill the order.

How Checkout.com handles DANA

Payrails creates the DANA payment through the Checkout.com Payment Setup API, and sends the order items with it.
Payrails sets the Checkout.com terminal type from meta.clientContext.clientType.
If Checkout.com doesn’t return a redirect for a pending DANA payment, Payrails fails the payment, because the customer can’t complete it.
Payrails doesn’t save the DANA payment method at Checkout.com, so Save Instruments and MIT aren’t available.

Getting Started

Payment Orchestration

Token Vault

Analytics & Reporting

Fraud Management

Chargebacks

Monitoring

Resources

Use Cases

How a DANA payment works

Supported currencies and countries

Supported workflows

Before you begin

Request fields for Checkout.com

Authorize a DANA payment

How Checkout.com handles DANA

​How a DANA payment works

​Supported currencies and countries

​Supported workflows

​Before you begin

​Request fields for Checkout.com

​Authorize a DANA payment

​How Checkout.com handles DANA

How a DANA payment works

Supported currencies and countries

Supported workflows

Before you begin

Request fields for Checkout.com

Authorize a DANA payment

How Checkout.com handles DANA