PAYIN Overview (Bangladesh)

Base URL

https://api.transacty.ai

Purpose

PAYIN is the incoming payment flow where a customer pays the merchant.

This section covers the Bangladesh rail (BDT, e-wallets like bKash/Nagad/Upay) on /v1/payins. For other regions, see India (UPI) and Europe (Open Banking).

Merchant flow

1. POST /v1/payins with Idempotency-Key.
2. Redirect the customer to paymentInfo.content (hosted checkout).
3. Wait for webhook or poll GET /v1/payins/:id until success or failed.
4. Credit your order only on success / payin.completed.

On create, the response is pending and includes a hosted checkout URL at paymentInfo.content (where the customer pays) plus an estimated fees.platformFee and netAmount (what lands in your BDT wallet after the service fee).

Flow

Required Headers

• X-Transacty-Key
• X-Transacty-Signature
• X-Transacty-Timestamp
• Content-Type: application/json
• Idempotency-Key (required on create)

Limits

• Minimum amount: 200 BDT
• Maximum amount: 25000 BDT