Introduction

Create order for bank-account based transactions.

API Description

Request Method:POST

Request Path:open/api/transfer/payment

Parameters

Request Parameters

Parameter	Sign	Mandatory	Type	Length	Description
appId	Y	Y	string	64	AppId is unique for merchant
sign	N	Y	string	512	Sign
merchantOrderNo	Y	Y	string	64	Merchant order number (must be unique)
amount	Y	Y	string	20	Order amount (unit as fiat currency, 1=1.00) Mexican Peso: `MXN` (supports two decimal places) Nigerian Naira: `NGN` (does not retain decimal places)
currency	Y	Y	string	20	Fiat currency (unit of amount)
email	N	N	string	64	User email
callbackUrl	Y	Y	string	128	The address receiving order webhook
bankParam	N	N	object	1024	Bank account expend parameter
customParam	N	N	object	1024	Custom fields
remark	N	N	string	1024	Remark

NGN / MXN customParam Expend Parameter

Parameter	Sign	Mandatory	Type	Length	Description
bankCode	Y	Y	String	32	Bank code, refers to Bank Transfer Account Form api response
bankName	Y	Y	String	32	Bank name, refers to Bank Transfer Account Form api response
bankAccountNumber	Y	Y	String	32	Bank Account Number

Request Parameter Example

{
  "appId": "TEST000001",
  "sign": "TEST000001",
  "merchantOrderNo": "11187",
  "amount": "10000",
  "currency": "NGN",
  "feeType": "INNER_BUCKLE",
  "userId": "[email protected]",
  "userIp": "14.232.142.199",
  "email": "[email protected]",
  "callbackUrl": "http://127.0.0.1:8022/open/api/callback",
  "bankParam": {
    "bankCode": "044",
    "bankName": "Access Bank",
    "bankAccountNumber": "0773593323"
  }
}

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

{
  "code": "0",
  "msg": "success",
  "model": {
    "amount": "6.45",
    "orderNo": "400017506670013450114"
  },
  "traceId": "68590ef3ef9bd17e8671b85313daf949",
  "success": true,
  "error": false
}