IPAY

Overview:
iPay supports receiving payments and payouts to global wallets in multiple countries, including Sri Lanka.

Payin

Request body:

Field	Type	Requirement Level	Description
amount	number	Required	Amount in LKR
currency	string	Required	"LKR"
method_code	string	Required	"IPAY"
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": 100,
  "currency": "LKR",
  "method_code": "IPAY",
  "reference": "INV-2025-001",
  "metadata": {
    "internal_id": "user1234"
  },
  "webhook_url": "https://yourwebsite.com/webhook",
	"callback_url": "https://yourwebsite.com/callback",
  "customer": {
    "first_name": "Firstname",
		"last_name": "lastname",
    "address": "No 2, Green Median Str",
    "phone": "[phone]",
    "email": "[email protected]",
		"country": "LK"
  },
	"ip_address": "0.0.0.0"
}

Payout

Request body

Field	Type	Requirement Level	Description
amount	number	Required	Amount in the local currency
currency	string	Required	Local currency code
method_code	string	Required	"IPAY"
recipient.wallet_uid	string	Required	Recipient’s 10-digit iPay wallet
recipient.full_name	string	Required	Recipient’s full name
reference	string	Required	Merchant reference
country	string	Required	Country (iso2)
metadata	object	Optional	Merchant metadata
webhook_url	string	Optional	HTTPS URL for 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": "LKR",
  "method_code": "IPAY",
  "recipient": {
    "wallet_uid": "01712345678",
    "full_name": "Firstname Surname"
  },
  "reference": "INV-2025-001",
  "country": "LK",
  "metadata": {
    "internal_id": "user1234"
  },
  "webhook_url": "https://yourwebsite.com/webhook",
  "sender": {
    "full_name": "Firstname Surname",
    "address": "No 2, Green Median Str"
  }
}