Create Payout (Bangladesh)

POST/v1/payoutspayout:create

Create a payout transaction. You may send an optional Idempotency-Key header to safely retry the same request.

Request fields

Field	Type	Required	Description
`amount`	`string` (numeric)	Yes	Payout amount sent to the beneficiary (BDT)
`benificiaryAccountInfo`	`object`	Yes	Beneficiary wallet / account details
`benificiaryAccountInfo.number`	`string`	Yes	Wallet/account number
`benificiaryAccountInfo.orgId`	`string`	Yes	Organization id (e.g. `BKASH`)
`benificiaryAccountInfo.orgCode`	`string`	Yes	Organization code
`benificiaryAccountInfo.orgName`	`string`	Yes	Organization name
`benificiaryAccountInfo.holderName`	`string`	Yes	Beneficiary name
`cardHolderInfo`	`object`	Yes	Sender identity on file
`cardHolderInfo.firstName`	`string`	Yes	First name
`cardHolderInfo.lastName`	`string`	Yes	Last name
`cardHolderInfo.email`	`string`	Yes	Email
`cardHolderInfo.phone`	`string`	Yes	Phone

Example

Request


{
  "amount": "300",
  "benificiaryAccountInfo": {
    "number": "01712345678",
    "orgId": "BKASH",
    "orgCode": "BKASH",
    "orgName": "BKASH",
    "holderName": "John Doe"
  },
  "cardHolderInfo": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "john@example.com",
    "phone": "01712345678"
  }
}

cURL

curl -X POST https://api.transacty.ai/v1/payouts \
  -H "X-Transacty-Key: $TRANSACTY_KEY" \
  -H "X-Transacty-Timestamp: $TS" \
  -H "X-Transacty-Signature: $SIG" \
  -H "Content-Type: application/json" \
  -d '{
  "amount": "300",
  "benificiaryAccountInfo": {
    "number": "01712345678",
    "orgId": "BKASH",
    "orgCode": "BKASH",
    "orgName": "BKASH",
    "holderName": "John Doe"
  },
  "cardHolderInfo": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "john@example.com",
    "phone": "01712345678"
  }
}'

Response


{
  "transactionId": "6c7c26ab-23b4-48a1-ab4d-929f8184cff3",
  "status": "PENDING",
  "amount": "300",
  "recipient": {
    "benificiaryAccountInfo": {
      "number": "01712345678",
      "orgId": "BKASH",
      "orgCode": "BKASH",
      "orgName": "BKASH",
      "holderName": "John Doe"
    },
    "cardHolderInfo": {
      "firstName": "John",
      "lastName": "Doe",
      "email": "john@example.com",
      "phone": "01712345678"
    }
  },
  "estimatedCompletion": "2026-06-29T11:33:03.113Z",
  "currency": "BDT",
  "fees": {
    "platformFee": "15.00",
    "feeType": "payout",
    "feeStatus": "estimated"
  },
  "netAmount": null,
  "totalWalletDebit": "315.00"
}

Response fields

Field	Type	Description
`transactionId`	`string`	Transaction identifier — use for status polling and support
`status`	`string`	e.g. `PENDING` while the payout is processing
`amount`	`string`	Amount sent to the beneficiary
`currency`	`string`	Payout currency — `BDT`
`recipient`	`object`	Echo of beneficiary and card-holder details from the request
`recipient.benificiaryAccountInfo`	`object`	Destination wallet / account
`recipient.cardHolderInfo`	`object`	Sender identity
`estimatedCompletion`	`string` (ISO datetime)	Estimated time the payout completes
`fees`	`object`	Transacty service fee for this payout
`fees.platformFee`	`string`	Fee amount charged for the service
`fees.feeType`	`string`	`payout`
`fees.feeStatus`	`string`	e.g. `estimated` at create
`netAmount`	`string \| null`	`null` at create; settled amount after fees when complete
`totalWalletDebit`	`string`	Total debited from your BDT wallet (`amount` + `platformFee`)

Note the spelling benificiaryAccountInfo in the request body — it must match exactly.

Wallet debit: totalWalletDebit is what leaves your BDT balance immediately (e.g. 300 payout + 15 fee = 315.00). fees.platformFee is the Transacty service charge. amount is what the beneficiary receives.