NAGAD

Overview:
Nagad is a Bangladeshi mobile wallet for instant payouts to verified users.

Payin

Payin request body:

Field	Type	Requirement Level	Description
amount	number	Required	Amount in BDT
currency	string	Required	"BDT"
method_code	string	Required	"NAGAD"
reference	string	Required	Merchant reference
description	string	Optional	Description for this payment
metadata	object	Optional	Merchant metadata, returned in notifications
webhook_url	string	Optional	HTTPS URL for payout notifications
customer.first_name	string	Optional	Customer's first name
customer.last_name	string	Optional	Customer's last name
customer.email	string	Optional	Customer's email address
customer.phone	string	Optional	Customer's phone number
customer.address	string	Optional	Customer's address
customer.city	string	Optional	Customer's city
customer.state	string	Optional	Customer's state
customer.zip	string	Optional	Customer's zipcode
customer.country	string	Required	Customer's country (iso2)
ip_address	string	Optional	Sever's IP Address

Sample Payload:

JSON

{
  "amount": 150,
  "currency": "BDT",
  "reference": "123456DDEDDX2C7890XXXXXXX",
  "method_code": "NAGAD",
  "description": "Payment for order 1234567890XXXXXXX",
  "metadata": {
    "order_id": 123,
    "user_id": 123
  },
  "callback_url": "https://cb2de49c4104.ngrok-free.app/callback",
  "webhook_url": "https://cb2de49c4104.ngrok-free.app/webhook",
  "customer": {
    "country": "BD"
  }
}

Payout

Payout request body:

Field	Type	Requirement Level	Description
amount	number	Required	Amount in BDT
currency	string	Required	"BDT"
method_code	string	Required	"NAGAD"
recipient.wallet_uid	string	Required	Recipient’s 11-digit Nagad wallet number
recipient.full_name	string	Required	Recipient’s full name
reference	string	Required	Merchant reference
country	string	Required	Country (iso2)
metadata	object	Optional	Merchant metadata, returned in notifications
webhook_url	string	Optional	HTTPS URL for payout notifications
sender.full_name	string	Optional	Sender's full name
sender.address	string	Optional	Sender's address
sender.phone	string	Optional	Sender's phone number

Sample Payload:

JSON

{
  "amount": 100,
  "currency": "BDT",
  "method_code": "NAGAD",
  "recipient": {
    "wallet_uid": "01812345678",
    "full_name": "Firstname Surname"
  },
  "reference": "INV-2025-001",
	"country": "BD",
  "metadata": {
    "internal_id": "user1234"
  },
  "webhook_url": "https://yourwebsite.com/webhook",
  "sender": {
    "full_name": "Firstname Surname",
    "address": "No 2, Green Median Str"
  }
}