> For the complete documentation index, see [llms.txt](https://docs.doku.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.doku.com/get-started/manage-business/manage-payment-methods/cards.md).

# Cards

Accept card payments from customers using credit or debit cards issued by banks in Indonesia and abroad.

## Overview

Cards lets your business accept online card payments through DOKU. Most business start with **Regular Sale** using DOKU's aggregator service, while other transaction types and direct bank arrangements are available for eligible business needs.

{% hint style="success" icon="lightbulb" %}
**Start accepting card payments with DOKU**\
Regular Sale with DOKU (Aggregator) is the standard way to get started. You can activate it through the DOKU Dashboard without setting up a separate agreement with an acquiring bank.&#x20;

Your initial activation covers **local cards issued in Indonesia (**[**see how to**](https://app.gitbook.com/o/bZnsbvZIGP9rjKqD5CBu/sites/site_FmmmF/s/WIsxU2UGMS7iidoMSuyz/~/edit/~/changes/369/get-started/manage-business/manage-payment-methods/cards#step-3-activate-in-doku-dashboard)**)**. To accept **overseas cards**, set up **Country BIN after approval (**[**see how to**](https://app.gitbook.com/o/bZnsbvZIGP9rjKqD5CBu/sites/site_FmmmF/s/WIsxU2UGMS7iidoMSuyz/~/edit/~/changes/369/get-started/manage-business/manage-payment-methods/cards#configuration)**)**. All card payments are charged in **IDR**.
{% endhint %}

### Card Payment Flow

<figure><img src="https://1457116080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWIsxU2UGMS7iidoMSuyz%2Fuploads%2FHgo0mbWpeTflfVm1MveC%2Fcards-payment-flow.png?alt=media&amp;token=ae2daa88-bf3b-442f-84cf-39f42a55b293" alt="" width="563"><figcaption></figcaption></figure>

### Activate Cards in 3 Steps

1. [Check Eligibility](#check-eligibility)
2. [Prepare Documents](#prepare-documents)
3. [Activate in DOKU Dashboard](#activate-in-doku-dashboard)

## Activation

### Step 1: Check Eligibility

Before activating Cards, make sure your business is operating, your documents are ready, and customers can access the information they need before making a purchase. Make sure the following are ready:

* Your DOKU Business Account is registered and verified.
* Your business information is complete.
* Your business has a legal business document recognized in Indonesia, such as an NIB.
* Your business is already operating and has proof of activity with real customers.
* Your customer support contact information is publicly accessible.

These requirements help DOKU verify that your business is legitimate, actively serving customers, and provides clear information about its products or services.

### Step 2: Prepare Documents

DOKU reviews your documents to confirm that your business is legitimate, actively serving customers, and provides clear information about its products or services. Screenshots and digital records are accepted as long as they clearly show the relevant activity.

#### Activation Checklist

Use this checklist to confirm that your business is ready before request the activation.

* [ ] Your business has a valid legal business document recognized in Indonesia.
* [ ] Your business is already operating.
* [ ] Proof of communication with customers is available.
* [ ] An invoice or proof of order is available.
* [ ] Proof of payment or transaction is available.
* [ ] Proof of delivery or service completion is available.
* [ ] Proof that the customer received the goods or service is available.
* [ ] Your website or public business page is accessible.
* [ ] Customer Support can be reached by customers.
* [ ] Terms & Conditions are publicly accessible.
* [ ] Refund Policy is publicly accessible.

#### **Documents to Prepare**

Prepare evidence of your business operations and the information customers need to understand your business and resolve issues.

<table data-search="false"><thead><tr><th width="159.640625">Type</th><th width="245.05078125">Document / Information</th><th>Examples</th></tr></thead><tbody><tr><td>Proof of Business Operations</td><td>Customer communication</td><td>Email, WhatsApp chat, or customer support ticket</td></tr><tr><td></td><td>Invoice or order and payment evidence</td><td>Invoice, order details, billing record, or proof of payment</td></tr><tr><td></td><td>Proof of delivery or service completion</td><td>Shipping receipt, service completion evidence, or service activation notification</td></tr><tr><td></td><td>Proof that goods or services were received</td><td>Customer confirmation, completed order status, or customer feedback</td></tr><tr><td>Customer-Facing Information</td><td>Customer Support</td><td>Contact Us page, support email, or official WhatsApp</td></tr><tr><td></td><td>Terms &#x26; Conditions</td><td>Publicly accessible Terms &#x26; Conditions page or document</td></tr><tr><td></td><td>Refund Policy</td><td>Publicly accessible Refund Policy page or document</td></tr></tbody></table>

The evidence should show real business activity and the relationship between your business and its customers. Screenshots and digital records may be used when they clearly demonstrate the relevant activity.

#### **Example Documents by Business Type**

The examples below illustrate the types of evidence you can prepare based on your business model. Use the examples relevant to your business and ensure the links you submit are publicly accessible.

<details>

<summary><strong>SaaS / Digital Platform</strong></summary>

For SaaS and digital platform businesses, provide evidence of subscriptions, customer billing, platform usage, and service delivery.

<table data-search="false"><thead><tr><th width="193.85546875">Document / Information</th><th>Description</th></tr></thead><tbody><tr><td>Customer communication</td><td>Emails, WhatsApp conversations, or customer support tickets</td></tr><tr><td>Invoice or order and payment evidence</td><td>Subscription invoice, customer billing record, dashboard billing screenshot, or proof of payment</td></tr><tr><td>Proof of service completion</td><td>Active customer dashboard, service activation notification, or enabled platform features</td></tr><tr><td>Proof that the service has been received</td><td>Customer confirmation email, chat confirming service availability, or customer feedback</td></tr><tr><td>Customer Support</td><td>Help Center, Customer Support page, support email, or official WhatsApp</td></tr><tr><td>Terms &#x26; Conditions</td><td>Public link to the platform's Terms &#x26; Conditions</td></tr><tr><td>Refund Policy</td><td>Public link to the platform's Refund Policy</td></tr></tbody></table>

</details>

<details>

<summary><strong>E-Commerce / Online Store</strong></summary>

For e-commerce businesses, provide evidence of customer orders, payments, shipping, and delivery.

<table data-search="false"><thead><tr><th width="191.76953125">Document / Information</th><th>Description</th></tr></thead><tbody><tr><td>Customer communication</td><td>Order confirmation email, WhatsApp, social media DM, or support ticket</td></tr><tr><td>Invoice or order and payment evidence</td><td>Sales invoice, order details from the store dashboard, or proof of payment</td></tr><tr><td>Proof of shipment</td><td>Courier receipt or shipment status from JNE, J&#x26;T, SiCepat, or another courier</td></tr><tr><td>Proof that goods have been received</td><td>Customer review, photo of received goods, or completed order status</td></tr><tr><td>Customer Support</td><td>Contact Us page, official WhatsApp, or public support email</td></tr><tr><td>Terms &#x26; Conditions</td><td>Public link to the store's Terms &#x26; Conditions</td></tr><tr><td>Refund Policy</td><td>Public link to the store's Return &#x26; Refund Policy</td></tr></tbody></table>

</details>

<details>

<summary><strong>Hospitality, Hotels, and Villas</strong></summary>

For hospitality businesses, provide evidence of reservations, payments, guest stays, and service completion.

<table data-search="false"><thead><tr><th width="191.50390625">Document / Information</th><th>Description</th></tr></thead><tbody><tr><td>Customer communication</td><td>Reservation confirmation email, guest WhatsApp, or messages from Booking.com, Agoda, Airbnb, or other booking platforms</td></tr><tr><td>Invoice or order and payment evidence</td><td>Reservation invoice, booking details, proof of deposit, or proof of full payment</td></tr><tr><td>Proof of service completion</td><td>Check-in or check-out status, guest folio, or check-out receipt</td></tr><tr><td>Proof that the service was received</td><td>Guest review, check-in or check-out form, or feedback via chat or email</td></tr><tr><td>Customer Support</td><td>Contact or Reservation page, front desk number, or property WhatsApp</td></tr><tr><td>Terms &#x26; Conditions</td><td>House Rules or reservation Terms &#x26; Conditions</td></tr><tr><td>Refund Policy</td><td>Public Cancellation &#x26; Refund Policy</td></tr></tbody></table>

</details>

### Step 3: Activate in DOKU Dashboard

Once your business meets the requirements and your documents are ready, follow the steps below to activate Regular Sale with DOKU (Aggregator).

1. Log in to your [DOKU Dashboard](https://dashboard.doku.com/bo/login?utm_source=docs).
2. Select **Settings** from the menu
3. **Settings** page will appear. Under **Account** section, select **Service**
4. On **Service** page, click **ADD SERVICE** button

<div align="left"><figure><img src="https://1457116080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWIsxU2UGMS7iidoMSuyz%2Fuploads%2Fs7PaYCwEPd5cVXW4f4UZ%2Fqris-step3-1-add-service%20(1).png?alt=media&amp;token=d9e8f59f-0e34-4d54-9cc5-591c78d36fcb" alt="" width="375"><figcaption></figcaption></figure></div>

4. Select **Regular Sale - DOKU** under Cards section, then click **ACTIVATE**

<div align="left"><figure><img src="https://1457116080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWIsxU2UGMS7iidoMSuyz%2Fuploads%2F9v2P3wL7nSix0mQLmnVN%2Fcards-select-regular-sale%20(2).png?alt=media&amp;token=37760e44-c031-4658-8bcf-805e6f7aaeda" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" icon="circle-info" %}
If you have any further questions or encounter any issues, please contact our Customer Support team at <care@doku.com>.
{% endhint %}

Your activation will go through a verification process. Make sure the information and documents you provide are complete and accessible.

### Common Activation Mistakes

Avoid these common mistakes to help prevent delays or rejection of your Cards activation.

| Mistake                                                        | ✅ What to Do Instead                                                                                          |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Customer-facing links are not publicly accessible              | Check that your Terms & Conditions, Refund Policy, and Customer Support links work without requiring a login. |
| Documents do not show real business activity                   | Provide evidence of actual customer interactions, orders, payments, and service delivery.                     |
| Documents do not cover the full transaction flow               | Include relevant evidence from customer communication through payment and delivery or service completion.     |
| Your business is not yet operating                             | Apply once your business has real operational activity and evidence involving customers.                      |
| Documents relate to transactions on behalf of another business | Provide evidence of transactions for your own products or services.                                           |
| Submitted information is incomplete or inconsistent            | Review your activation document and supporting evidence before submitting.                                    |

## Configuration

#### **Accept Overseas Cards (Country BIN)**

{% hint style="success" icon="circle-info" %}
For overseas (international) transactions only. Country BIN settings apply to cards issued outside Indonesia. **If you only accept local cards, you don't need to change anything here.** **Overseas card payments are still charged in IDR.**
{% endhint %}

**Your first activation covers local cards.** After it's approved, you can enable overseas cards by choosing which countries' cards your business accepts. To do this, follow the steps below:

1. Log in to [DOKU Dashboard](https://dashboard.doku.com/bo/login?utm_source=docs), and then access the side navigation bar
2. Select **Settings** from the menu
3. **Settings** page will appear. Under **Payment Configuration** section, select **Cards**
4. **Cards Settings** page will appear, then click **Payment Configuration** tab
5. **Payment Configuration** tab will appear. Under Country & BIN Filtering section, select either of the two options: (1) Allow all BIN countries or (2) Allow partial countries. Selecting partial countries will require you to select the country of your choice\
   ![](https://1457116080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWIsxU2UGMS7iidoMSuyz%2Fuploads%2Fjcj3XmfVrCQ3uzE2jrzj%2Fimage.png?alt=media\&token=c62314f0-2552-45f9-b88e-da7f308fb554)
6. Click **Save** to submit.

{% hint style="success" icon="circle-info" %}

#### Country Restrictions

* **High-Risk Jurisdictions (Black List):** Cards issued in North Korea, Iran, and Myanmar cannot be enabled.
* **Jurisdictions under Increased Monitoring (Grey List):** Requests involving these countries are subject to additional review and may be declined such as Nepal, Syria, Vietnam, etc.&#x20;

For the latest country classifications, [refer to the FATF reference list.](https://www.fatf-gafi.org/en/countries/black-and-grey-lists.html)
{% endhint %}

## Transaction Types & Acquirers

This section is for businesses that need more than Regular Sale through DOKU (Aggregator).

### Transaction Types

<table><thead><tr><th width="166.7109375">Transaction Type</th><th width="335.9140625">Description</th><th>Common Use</th></tr></thead><tbody><tr><td><strong>Regular Sale</strong><br><mark style="background-color:$success;">Most common</mark></td><td>Charge the full payment amount to the customer's card in a single transaction.</td><td>Online purchases and one-time services</td></tr><tr><td><strong>Installment</strong></td><td>Let customers pay for a purchase in monthly installments through a participating bank's installment program.</td><td>Electronics, travel packages, and other high-value purchases</td></tr><tr><td><strong>MOTO</strong> (Mail Order / Telephone Order)</td><td>Accept card payments when customers provide their card details remotely by phone, email, or mail.</td><td>Orders and reservations made by phone or email</td></tr><tr><td><strong>Pre-Authorization</strong></td><td>Place a hold on the customer's card and charge the amount later, when the final amount is confirmed.</td><td>Hotel deposits and vehicle rentals</td></tr></tbody></table>

### Acquirers

An acquirer is a bank or financial institution that processes card payments for your business. DOKU offers two arrangements.

**DOKU (Aggregator)**\
DOKU processes your card transactions using its merchant ID registered with acquiring banks. You do not need to arrange a separate agreement with a bank. This is the standard option activated through the DOKU Dashboard.

**Direct**\
Your business has its own agreement with an acquiring bank, while DOKU provides the technical integration. Direct requires agreements with both the acquiring bank and DOKU. Contact Sales for eligibility, available features, and setup requirements.

## FAQs

#### General

<details>

<summary>What are the main requirements to activate Cards?</summary>

Your business must have a legal business document recognized in Indonesia. You also need to provide proof of business operations and customer-facing information that is publicly accessible to customers. For the full list of documents, see Activation Requirements.

</details>

<details>

<summary>I want to help my clients accept card payments. What should I do?</summary>

Your clients need to be registered as separate businesses on DOKU. For Agencies, Consultants, or Technology Partners with many clients, you may want to consider the DOKU Partner program. See Agency or Consultant Businesses.

</details>

<details>

<summary>Do all documents have to be formal documents?</summary>

Not necessarily. Documents can be screenshots or files that show real business activity, such as emails, WhatsApp chats, support tickets, invoices, order dashboards, shipping receipts, UAT Acceptance Forms, or handover documents.

Make sure the information in the documents shows the relationship between your business and your customers, as well as the ordering, payment, or service completion process.

</details>

#### Eligibility

<details>

<summary>Can I activate Cards as an individual merchant?</summary>

Yes, as long as your business has a legal business document recognized in Indonesia, such as an NIB.

</details>

<details>

<summary>My business is not yet operating. Can I still activate Cards?</summary>

Not yet. Merchants need to have operational activity and proof of interactions or transactions with customers as part of the verification process. See Businesses That Are Not Yet Operating.

</details>

<details>

<summary>I run an Agency or Consultancy. Can I accept card payments from my clients?</summary>

Yes, as long as the payment is for work or services provided by the Agency or Consultant itself, such as project invoices, consulting fees, development fees, or retainers. However, an Agency’s DOKU account cannot be used to receive payments on behalf of its clients.

</details>

#### Rejection

<details>

<summary>Why was my Cards activation rejected?</summary>

Your Cards application may be rejected if the information submitted does not sufficiently show real business activity or if customer-facing information cannot be accessed.

Common reasons include:

* The business does not have a legal business document recognized in Indonesia.
* Documents do not show transactions with real customers.
* The documents do not cover the full transaction flow.
* Customer Support, Terms & Conditions, or Refund Policy links cannot be accessed publicly.
* The business is not yet operating.
* The submitted documents relate to transactions on behalf of another business.

To learn more, see Common Mistakes.

</details>

<details>

<summary>What should I do after my Cards activation is rejected?</summary>

First, check the rejection reason shown in your DOKU Dashboard. Then:

1. Identify the documents or information that need to be corrected.
2. Complete or replace the relevant documents, and make sure all customer-facing links are publicly accessible.
3. Review the Activation Checklist.
4. Submit your Cards application again after the issue has been resolved.

If you need further assistance, contact DOKU Customer Support.

</details>

#### Transaction Types and Acquirers

<details>

<summary>Which transaction type and acquirer will I get after activating Cards?</summary>

Activating Cards through the DOKU Dashboard enables Regular Sale transactions with DOKU (Aggregator). Transactions are processed using DOKU’s merchant ID, so you do not need your own agreement with a bank.

</details>

<details>

<summary>What is the difference between DOKU (Aggregator) and Direct?</summary>

With DOKU (Aggregator), transactions are processed using DOKU’s merchant ID registered with acquiring banks. With Direct, your business has its own agreement with an acquiring bank, and DOKU acts as the technical facilitator.

</details>

<details>

<summary>Can I use Installment, MOTO, Pre-Authorization, Recurring, or a Direct acquirer?</summary>

Yes, these are available upon request. Contact the DOKU team to discuss your business needs. See [Availability](#availability).

</details>

#### Integration and Testing

<details>

<summary>How to activate Cards in the staging environment (DOKU Sandbox)?</summary>

You don’t need to activate Cards in DOKU Sandbox. Regular Sale – DOKU is automatically active once you create a DOKU Sandbox account, so you can start simulating card payments right away.

To create a DOKU Sandbox account:

1. Visit the [DOKU Sandbox Registration page](https://sandbox.doku.com/bo/sandbox-registration).
2. Fill in the registration form with your full name, business name, business email address, and password.
3. Check the Terms and Conditions and Privacy Policy, then submit the form.
4. Log in to [DOKU Sandbox](https://sandbox.doku.com/bo/login) using the credentials you used in the registration form.

Once logged in, you can retrieve your Sandbox Client ID and Secret Key to start testing your integration.

</details>

<details>

<summary>How to integrate Cards via API?</summary>

</details>

<details>

<summary>How to integrate Cards via plugins?</summary>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.doku.com/get-started/manage-business/manage-payment-methods/cards.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
