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

​
Before you start

​
Steps

  1. Open the Doku Dashboard.
  2. In the left sidebar, select Settings, then under Account, select API Keys.
Doku Dashboard Settings page with the API Keys link highlighted in the Account column
  1. Select Copy Client ID, then select Copy Secret Key to copy your Active Secret Key.
Doku API Keys page with the Copy Client ID and Copy Secret Key buttons highlighted
  1. Open Integrations in bitbybit, then select Connect on the Doku card.
bitbybit Integrations page with the Connect button on the Doku card highlighted
  1. 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.

​
Steps

  1. In bitbybit, go to Settings → Commerce → Order settings and find the Payment methods card.
  2. On the Doku row, select the edit icon to open Doku configuration.
  3. 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.