Bangladesh / payout API

Bangladesh payout API.
bKash, Nagad and Upay transfers.

Send BDT payouts to bKash, Nagad and Upay accounts through the PAYJN API. Agree beneficiary requirements, funding, transaction states and the support process for your approved business before production.

Where you can send payouts in Bangladesh

PAYJN supports BDT payouts to bKash, Nagad and Upay accounts. Common uses include seller settlements, commissions and customer withdrawals.

Bangladesh payout destinations
DestinationWhat the recipient receivesRecipient details
bKashBDT sent to a bKash accountAccount identifier as specified in your documentation
NagadBDT sent to a Nagad accountAccount identifier as specified in your documentation
UpayBDT sent to a Upay accountAccount identifier as specified in your documentation

Payouts are approved separately from collections. Confirm which destinations and beneficiary types are enabled for your merchant setup before you submit payout orders.

Prepare a payout request

BDT payout setup checklist
AreaConfirm with the team
BeneficiaryWallet type and the required destination fields
Amount and currencyBDT amount format, fees and current payout limits
FundingRequired balance, charges and funding arrangements
Order referenceOne stable merchant reference per payout and the supported retry rules
Status verificationCallback handling and the documented status-query process

Use the codes and field formats from your approved PAYJN integration documentation. Do not substitute a wallet display name for its documented code.

How a Bangladesh payout flow works

A reliable payout integration separates "the request was accepted" from "the money arrived". Plan each step and the record your system keeps at that step.

  1. Fund the balance so it covers the payout amount and charges, according to your agreed arrangement.
  2. Validate the beneficiary: check the wallet type and account identifier, and use account validation where the route supports it.
  3. Create the payout with a unique reference: one business payout, one merchant reference. Store it before sending the request.
  4. Record the immediate response: an accepted or processing response means the request is being handled, not that the recipient has been paid.
  5. Confirm the final state from the verified callback, and query the payout status if the callback is late.
  6. Reconcile each payout against the transaction record and balance movements, including charges and any returned transfers.

Beneficiary checks before sending

Wrong or outdated destination details can lead to rejected or misdirected payouts, so check them before you send.

  • Wallet type: record which wallet the recipient uses (bKash, Nagad or Upay) as a separate field, not inside a free-text note.
  • Account identifier: collect the identifier your documentation requires, typically the mobile number linked to the wallet, and validate its format.
  • Name checks: where the route returns an account name, compare it with your records and hold payouts that do not match for review.
  • Changes: treat a changed wallet account as a new beneficiary and apply your approval rule before the first payout to it.

Payout states and what your system should do

Payout states (illustrative; use the names in your approved documentation)
StateMeaningYour system should
Accepted / processingRequest received and being handledWait for the final state; do not resend
SuccessfulPayout completed by the routeMark the obligation paid; keep the PAYJN reference
Failed / rejectedPayout not completedCheck the reason, correct the details, and approve any new payout explicitly
ReturnedFunds came back after an initial successReopen the obligation and contact the recipient
Unknown after timeoutNo clear response to your requestQuery the status first; never create a second payout

Avoid duplicate payouts after a timeout

If your payout request times out, the payout may still have been created. Sending a new payout with a new reference can pay the same person twice. Keep the original reference, query the payout status, and only create a replacement after the original is confirmed as failed and someone has approved the replacement. The payout timeout and retry checklist explains this rule in detail; it applies in Bangladesh as well.

Successful payout, but the recipient has not received it

First compare the wallet type, account identifier, amount and time in your record with the PAYJN transaction. Then ask the recipient to check the right wallet account and its transaction history. If it still does not match, send the payout reference, amount and time to PAYJN support through the agreed channel. Do not send the payout again while the original is being investigated.

Funding and controls

  • Keep enough balance for scheduled payout batches, including charges.
  • Set approval rules for large payouts and for the first payout to a new beneficiary.
  • Separate the people who add beneficiaries from the people who approve payouts.
  • Reconcile payouts daily and review every failed or returned transfer.

For collections, wallet payment steps and reconciliation, see the Bangladesh payment API page and the bKash and Nagad integration checklist.

Payout availability, destinations, limits, fees and timing are confirmed for each approved merchant. PAYJN does not claim to be a bank or a Bangladesh-licensed payment institution and does not imply a partnership with any named wallet provider.

Bangladesh payout FAQ.

Can PAYJN send payouts to bKash, Nagad and Upay?

Yes. PAYJN supports BDT payouts to bKash, Nagad and Upay accounts. The destinations enabled for your business are confirmed during onboarding.

Should I resend a payout after a request timeout?

No. Query the payout status with the original reference first. Create a replacement only after the original is confirmed as failed and the replacement has been approved.

What if the account name does not match my records?

Hold the payout and confirm the details with the recipient. Where the route returns an account name, use it as a check before sending, not after.

Are payouts approved separately from collections?

Yes. Collection approval does not by itself enable payouts. Payout destinations, limits and funding are reviewed for each merchant.

What do I need to start Bangladesh payouts?

Your company details, who you pay and why, expected payout volume and average amount, the wallets you need, and how you will fund the payout balance.

Bangladesh payouts

Discuss your Bangladesh payout flow.

Tell us who you pay, how often and the expected BDT volume. We will reply with a practical next step.

Request a Bangladesh payout proposal →