# Checkout Settings

**For a seamless and brand-consistent invoicing experience, we recommend configuring your payment page settings before issuing your first invoice.** Access the dedicated Checkout Settings section within your DOKU Dashboard nor API requests to personalize your invoices in a variety of ways.

### Use your preferred Payment Method

You can configure your preferred payment method that will appear on your Checkout Page. Please make sure that the payment method service already active by following this [section](https://docs.doku.com/get-started/manage-business/activate-services).

1. **Specify Payment Method via Dashboard**

   You can choose which payment method that will be show and the order. 

   1. Login to DOKU Dashboard
   2. Go to **Setting > Checkout Page > Payment Method Settings Tab** 
   3. Click on your chosen payment method by tick on the checkbox
   4. Drag the line icon to set the payment method order
   5. Click **save**

      <figure><img src="/files/a7Q0lFVxS5tPMw2bT7R8" alt=""><figcaption></figcaption></figure>
2. **Specify Payment Method via API Request**

   DOKU allows you to customize your payment experience by setting your preferred payment methods based on API requests. This comes in handy in several situations:

   * **Controlling the payment method appearance:** You can choose which payment methods appear on your website and map the certain payment method. This gives you the greater control over the user interface and branding.&#x20;
   * **Offering targeted payment options:** You can tailor the available payment methods to specific customer segments or purchase types. For example, you might offer faster checkout options for high-value orders or display local payment methods for international customers.

{% hint style="info" %}
**Note:** You don't need to create multiple DOKU client IDs to achieve these customizations. The API request approach provides a flexible and efficient way to manage your preferred payment methods.
{% endhint %}

```json
"payment": {
      "payment_method_types": [
          "VIRTUAL_ACCOUNT_BCA",
          "VIRTUAL_ACCOUNT_BANK_MANDIRI",
          "VIRTUAL_ACCOUNT_BANK_SYARIAH_MANDIRI",
          "VIRTUAL_ACCOUNT_DOKU",
          "VIRTUAL_ACCOUNT_BRI",
          "VIRTUAL_ACCOUNT_BNI",
          "VIRTUAL_ACCOUNT_BANK_PERMATA",
          "VIRTUAL_ACCOUNT_BANK_CIMB",
          "VIRTUAL_ACCOUNT_BANK_DANAMON",
          "ONLINE_TO_OFFLINE_ALFA",
          "CREDIT_CARD",
          "DIRECT_DEBIT_BRI",
          "EMONEY_SHOPEE_PAY",
          "EMONEY_OVO",
          "QRIS",
          "PEER_TO_PEER_AKULAKU",
          "PEER_TO_PEER_KREDIVO",
          "PEER_TO_PEER_INDODANA"
      ]
```

> For details of supported payment methods, please refer to this [section](/accept-payments/doku-checkout/supported-payment-methods.md)

The payment method appearance **priority takes place on payment method setup by API request**. So in case your API request is like below,&#x20;

```json
"payment": {
      "payment_method_types": [
          "VIRTUAL_ACCOUNT_BCA",
          "VIRTUAL_ACCOUNT_BANK_MANDIRI"
          ]
```

and the payment method you checked is **more** than the payment method above, then what will appear on the checkout page is the payment method that you entered in the API request (provided that the checkout page status is active on the dashboard).

<figure><img src="/files/TEePKVktM7fntrJwzPYE" alt="" width="297"><figcaption></figcaption></figure>

### Custom Expiry Time

1. **Custom order payment due date via Dashboard**

   You can set the default of order payment due date (expiry time) via DOKU Dashboard, by following step below.

   1. Login to DOKU Dashboard
   2. Go to **Setting > Checkout Page > Payment Method Settings Tab**&#x20;
   3. Go to due date section, input your preferred due date (in hours and minutes)
   4. Click **save**

   <figure><img src="/files/5ws81gTJZJsRmYIAAbB4" alt=""><figcaption><p>Expiry time on Dashboard</p></figcaption></figure>
2. **Custom order payment due date via API Request**

   You also could set the payment due date from API request, this refer to **each** order created.&#x20;

```json
"payment": {
      "payment_due_date": 60
}
```

If you are not put the parameter`payment_due_date`on your API request and Dashboard, the payment\_due\_date will automatically set by default in 60 minutes

### Custom Result Page URL

Use this feature if you want to set a custom result URL for customers to be redirected to after generating a payment code or making a payment.&#x20;

By default, DOKU will redirect the customer to DOKU success page. But you can override that configuration by specifying `callbacks.url` parameter. This will allow you to have specific redirect for each specific payment.

### Customize Interface of Checkout Page

DOKU Checkout integrates seamlessly with your website or app, letting you personalize the checkout experience with your brand elements. Upload your logo, choose from a range of header styles, and set your preferred language to create a familiar and cohesive checkout flow that builds trust and boosts conversions.

You could set the DOKU checkout interface via DOKU Dashboard, by follow these step :&#x20;

* Login to DOKU Dashboard
* Go to **Setting > Checkout Page > Interface Settings**
* Adjust your company **logo**
* Set your checkout **default language**
* Adjust **checkout interface** by your preferred color, luckily you can compare the desktop and mobile view!
* Click **save!**

<figure><img src="/files/J0ovn9IQdZPV1gC8gcFL" alt=""><figcaption><p>Change logo &#x26; default language</p></figcaption></figure>

<figure><img src="/files/kw6fbCYVa7okNZHwcF1q" alt=""><figcaption><p>Adjust Checkout Interface</p></figcaption></figure>

### Credit card installment - show tenor based on preference

{% hint style="info" %}
**Note:** Regarding credit card installment settings, merchants need to register their MID with their acquirer for full functionality. For detailed information on MID registration, please refer to this section.
{% endhint %}

**Use case :**

**If you only want to display general installment options for all acquirers (not specific to individual acquirers), you can do so through the API request.**&#x20;

For example, even though BCA offers 3, 6, and 12-month installments, you can choose to show only 3 and 6 months in your interface.

The sample request is :&#x20;

```json
"additional_info":{
  "allow_tenor" : [3,6]
}
```


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.doku.com/accept-payments/doku-checkout/checkout-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.