DANA via Checkout.com

Accept DANA payments with Checkout.com as the payment service provider (PSP).

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. Required fields must be present for the payment to succeed. Payrails sends Optional fields to the PSP when you include 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.
Each DANA payment is a new customer-initiated payment.

Getting Started

Payment Orchestration

Token Vault

Analytics & Reporting

Fraud Management

Chargebacks

Monitoring

Resources

Use Cases

Supported workflows

Before you begin

Request fields for Checkout.com

Authorize a DANA payment

How Checkout.com handles DANA

​Supported workflows

​Before you begin

​Request fields for Checkout.com

​Authorize a DANA payment

​How Checkout.com handles DANA

Supported workflows

Before you begin

Request fields for Checkout.com

Authorize a DANA payment

How Checkout.com handles DANA