[PayIn] BDT Payment Data

For shops with BDT currency, when creating a payin (POST /api/v1/payins) no additional fields are required in the paymentData object.

merchant_user_id and merchant_user_ip are mandatory root fields for this request.

paymentData fields

No BDT-specific paymentData fields are required for this payin contract.

Example request body

{
  "external_id": "PIN-BDT-001",
  "amount": "5000.00",
  "currency": "BDT",
  "shop_code": "your_bdt_shop",
  "merchant_user_id": "merchant-user-001",
  "merchant_user_ip": "203.0.113.10"
}

Response fields

Parameter	Type	Description
id	number	Payfield operation ID.
status	string	Current payin status.
external_id	string	Unique payin identifier from the request.
amount	string	Payin amount.
currency	string	Payin currency.
shop_code	string	Shop code used for routing.
merchant_user_id	string	Merchant user identifier from the request.
merchant_user_ip	string	User IP from the request.
paymentData.payment_link	string	Payment link for completing the payin.
transaction_type	string	Always payin.
created_at	string	Creation timestamp.
updated_at	string	Last update timestamp.
finalization_date	string	Returned when the payin reaches a final status.

Example response body

{
  "id": 12345,
  "status": "pending",
  "external_id": "PIN-BDT-001",
  "amount": "5000.00",
  "currency": "BDT",
  "shop_code": "your_bdt_shop",
  "merchant_user_id": "merchant-user-001",
  "merchant_user_ip": "203.0.113.10",
  "paymentData": {
    "payment_link": "https://pay.example.com/bdt/PIN-BDT-001"
  },
  "transaction_type": "payin",
  "created_at": "2025-12-05T10:00:00.000000Z",
  "updated_at": "2025-12-05T10:00:00.000000Z"
}

Omit paymentData in the request for this BDT payin contract. The response includes paymentData.payment_link when the payment link is available.

← Back to PayIn