Skip to main content
Connect Doku so it appears as a payment option when you create a Commerce order.

Before you start

1

Copy your Doku credentials

Open the Doku Dashboard. Under Settings → Account, open API Keys.
Doku Dashboard Settings page with the API Keys link highlighted in the Account column
Select Copy Client ID, then Copy Secret Key to copy your Active Secret Key.
Doku API Keys page with the Copy Client ID and Copy Secret Key buttons highlighted
2

Open Doku in bitbybit

Open Integrations and select Connect on the Doku card.
bitbybit Integrations page with the Connect button on the Doku card highlighted
3

Enter the credentials

Paste the Client ID and Secret Key, then select Continue.
bitbybit Doku connect modal with the Client ID and Secret Key fields highlighted
Treat your Active Secret Key like a password. Do not share it, paste it into support tickets, or include it in screenshots.

What happens next

After Doku is connected, you can choose Doku from the order payment-method picker. bitbybit then generates a payment link for the order and updates the payment status automatically once the customer pays — see Choose a payment method for orders. Connected gateways also appear under Settings → Commerce → Order settings in the Payment methods card.

Send shipping fees to a separate Doku settlement account

If you keep product revenue and shipping costs in different bank accounts, Doku can settle each order’s shipping fee to a second account automatically. bitbybit adds the split to every Doku payment link it generates, so you no longer reconcile shipping costs line by line.

Before you start

  • In the Doku Dashboard, add the bank account for shipping costs under Settings → Account → Bank Account and wait until its status is Verified. Copy its Bank Settlement ID, which looks like SBA-0001-123456789.
  • Keep your revenue account as the default settlement destination under Settings → Finance Setting → Settlement.
  • If split settlement is not active on your Doku merchant account yet, ask your Doku account manager to enable it.
1

Open Doku configuration

In bitbybit, go to Settings → Commerce → Order settings. In Payment methods, select the edit icon on the Doku row.
2

Set the shipping settlement account

Under Shipping settlement account, paste the Bank Settlement ID, then select Save.

How the split works

  • Every new Doku payment link carries a settlement rule for the order’s shipping fee, including shipping insurance when it is charged. Doku settles that amount to the shipping account and the rest of the net settlement, after Doku’s fees, to your default account.
  • Orders with free shipping, and orders where the shipping fee is not lower than the order total, settle entirely to your default account.
  • To stop splitting, clear the field and select Save. Payment links created earlier keep the rule they were created with.
  • If Doku rejects the Bank Settlement ID, the order cannot generate a payment link and bitbybit shows Doku’s error message. Check the ID and confirm the bank account is verified.