Introduction

Call this API when the user provides the recipient’s bank account details.

Verify that the recipient’s account information is correct and the account is active, and display the cardholder’s name for user confirmation before initiating the transfer.

API Description

Request Method:POST

Request Path:open/api/V2/bankCheck

Parameters

Request Parameters

Parameter	Sign	Mandatory	Type	Length	Description
appId	Y	Y	string	64	AppId is unique for merchant
currency	Y	Y	string	12	Fiat currency:`NGN`,`VND`
sign	N	Y	string	512	Sign
bankParam	Y	N	string	512	Dynamic form information (passing in the corresponding dynamic form information based on the currency)

Request Parameter Example (NGN)

{
	"appId": "XXXXX",
	"sign": "D18DE66EC86F41CFCEFD4B97AE646A7A6D91E86C",
	"currency": "NGN",
	"bankParam": {
		"bankCode": "XXX",
		"bankAccountNumber": "52XXX3284"
	}
}

Request Parameter Example (VND)

{
    "appId":"XXXX",     
    "sign":"D18DE66055ADB6BFFC9C897AE646A7A6D91E86C",
    "currency":"VND",
    "bankParam":{
        "type":"ACCOUNT_NUMBER",
        "bankCode":"VCB",
        "bankAccountNumber":"xxx"
    }
}

Response Parameters

Parameter	Type	Description
success	boolean	Success
error	boolean	Error
code	long	Response code
msg	string	Response message
traceId	string	Trace id
model	object	Response content

Response Parameter Example(NGN)

{
	"code": "0",
	"msg": "success",
	"model": {
		"bankId": "xx",
		"accountNumber": "52xxxx284",
		"phoneNumber": ""
	},
	"traceId": "691c3f0ec282a3d1db2701242e33508c",
	"error": false,
	"success": true
}

Response Parameter Example(VND)

{
	"code": "0",
	"msg": "success",
	"model": {
		"bankAccountName": "xxx"
	},
	"traceId": "691c3fea0060435066ae824447a444d9",
	"error": false,
	"success": true
}

Response Parameter Example(failed)

{
  "code": "1087",
  "msg": "Could not resolve account name. Check parameters (1087)",
  "model": null,
  "traceId": "691c46865a75171f9b19c93286a59f3e",
  "error": true,
  "success": false
}