Create Pay-in (Bangladesh)

POST/v1/payinspayin:create

Create a pay-in 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	Transaction amount
`paymentMethodCode`	`string`	Yes	Example: `BKASH`
`returnUrl`	`string` (HTTPS URL)	Yes	Your page where the customer returns after completing payment in the hosted checkout. Transacty forwards this to the payment provider; you do not configure the provider directly.
`customer`	`object`	Yes	Customer info object
`customer.name`	`string`	Yes	Customer name
`customer.email`	`string`	Yes	Customer email
`customer.phone`	`string`	Yes	Customer phone
`customer.deviceId`	`string`	Yes	Device id
`goodsInfo`	`object`	Yes	Product info object
`goodsInfo.name`	`string`	Yes	Product name
`goodsInfo.id`	`string`	Yes	Product/order id
`goodsInfo.price`	`string` (numeric)	Yes	Product price

Example

Request


{
  "amount": "500.00",
  "paymentMethodCode": "BKASH",
  "returnUrl": "https://merchant.example.com/checkout/success",
  "customer": {
    "name": "Rahim",
    "email": "rahim@example.com",
    "phone": "01712345678",
    "deviceId": "device-123"
  },
  "goodsInfo": {
    "name": "Order #1001",
    "id": "1001",
    "price": "500.00"
  }
}

cURL

curl -X POST https://api.transacty.ai/v1/payins \
  -H "X-Transacty-Key: $TRANSACTY_KEY" \
  -H "X-Transacty-Timestamp: $TS" \
  -H "X-Transacty-Signature: $SIG" \
  -H "Content-Type: application/json" \
  -d '{
  "amount": "500.00",
  "paymentMethodCode": "BKASH",
  "returnUrl": "https://merchant.example.com/checkout/success",
  "customer": {
    "name": "Rahim",
    "email": "rahim@example.com",
    "phone": "01712345678",
    "deviceId": "device-123"
  },
  "goodsInfo": {
    "name": "Order #1001",
    "id": "1001",
    "price": "500.00"
  }
}'

Response


{
  "transactionId": "f7c2f6d1-96df-4980-a514-7854726f52a0",
  "status": "pending",
  "amount": "1000.00",
  "platformOrderId": "2026062907000000018",
  "paymentInfo": {
    "content": "https://checkout.example/bd-wallet?token=...",
    "expiredTime": "20260630172055",
    "type": "url"
  },
  "expiresAt": "2026-06-29T11:35:55.681Z",
  "currency": "BDT",
  "fees": {
    "platformFee": "20.00",
    "feeType": "payin",
    "feeStatus": "estimated"
  },
  "netAmount": "980.00",
  "totalWalletDebit": null
}

Response fields

Field	Type	Description
`transactionId`	`string`	Transaction identifier — use for status polling and support
`status`	`string`	Usually `pending` until the customer pays
`amount`	`string`	Requested pay-in amount
`currency`	`string`	Pay-in currency — `BDT` for Bangladesh
`platformOrderId`	`string`	Provider-side order reference (support / escalation)
`paymentInfo`	`object`	Hosted checkout details for the customer
`paymentInfo.content`	`string`	Checkout URL — send the customer here to pay and complete the transaction
`paymentInfo.type`	`string`	e.g. `url`
`paymentInfo.expiredTime`	`string`	Provider-side link expiry (often `YYYYMMDDHHmmss`)
`expiresAt`	`string` (ISO datetime)	When this pay-in session expires
`fees`	`object`	Transacty service fee for this pay-in
`fees.platformFee`	`string`	Fee amount charged for the service
`fees.feeType`	`string`	e.g. `payin`
`fees.feeStatus`	`string`	e.g. `estimated` at create; may update on completion
`netAmount`	`string`	Amount credited to your wallet after fees (`amount` minus `platformFee` when estimated)
`totalWalletDebit`	`string \| null`	Reserved; `null` on pay-in create

Customer checkout: open or redirect the customer to paymentInfo.content. That is the hosted page where they complete payment (e-wallet checkout). platformOrderId is only a provider reference — it is not the payment link.

Fees: fees.platformFee is what Transacty charges for the service. netAmount is what you can expect to receive in your BDT wallet after that fee.