Add Bank To VA

Bank details of a merchant are assigned to an airpay virtual account so that we only accept payments transferred from this bank account else will not be accepted being an unverified source. This API will Add/Assign bank account shared by the merchant to a specific virtual account of airpay if we pass merchant id, virtual account no, UID, bank name, account number and ifsc code correctly.

POST

https://kraken.airpay.co.in/airpay/va/api/

Header

Parameter	Type Value	Description	Value Like
Content-Type required	String	application/x-www-form-urlencoded

Request Body

Parameter	Type Value	Description	Value Like
action required	String	Action to perform - add_bank	add_bank
private_key required	Alphanumeric (10-200)	Private Key (required) privatekey = hash(‘sha256’, secret.’@’.username.’:	:‘.password)
merchant_id required	Numeric	Merchant Id	1
virtual_account_number required	Numeric	Virtual account number or UID Unique user identifier from the merchant is required	2293640000000010242
UID required	Numeric	Virtual account number or UID Unique user identifier from the merchant is required
bank_name required	Varchar	Bank name	SC
account_number required	Numeric	Bank account number	6546797546469
ifsc_code required	Alphanumeric	Bank IFSC code	SC544646464
checksum required	Alphanumeric	Hash generated by : sha1(virtual_account_number.bank_name.account_number.ifsc_code.UID.action.merchant_id.private_key)	87605eeab56e404bfc410478a15ae3df319723c7

Success 200

Parameter	Type Value	Description	Value Like
STATUS required	Number	Status Code Success - 200 Failed - 400	200,400
MESSAGE required	String	Status Message Success - 200 Transaction in Process - 211 Failed - 400 Dropped - 401 Cancel - 402 Incomplete - 403 Bounced - 405 No Records - 503 Virtual account is invalid - 526	success,fail

Request Example

curl --location --request POST 'https://kraken.airpay.co.in/airpay/va/api/' \
--form 'action=add_bank' \
--form 'private_key=71a4efaf21c79864ec154babfc494f45fd1f65a570805084965d5b29486f1dfe' \
--form 'merchant_id=1' \
--form 'virtual_account_number=2293640000000010242' \
--form 'bank_name=SC' \
--form 'account_number=6546797546469' \
--form 'ifsc_code=SC544646464' \
--form 'checksum=87605eeab56e404bfc410478a15ae3df319723c7'

Success Response

HTTP/1.1 200 OK
 {
     "STATUS": "200",
     "MESSAGE": "Success"
 }

Error Response

HTTP/1.1 200 OK
 {
      "STATUS": "400",
      "MESSAGE": "Failed"
 }