Create Order

Create order API used for merchant/partner to initiate acquiring order.

EndPoint

POST /binancepay/openapi/order

Request Parameters

Attributes	Type	Required	Limitation	Description
merchantId	long	N	-	The merchant account id, issued when merchant been created at Binance.
subMerchantId	long	N	-	The sub merchant account id, issued when sub merchant been created at Binance, The parameter subMerchantId is required when configuring show subMerchant info.
merchantTradeNo	string	Y	letter or digit, no other symbol allowed, maximum length 32	The order id, Unique identifier for the request
tradeType	string	Y	"WEB", "APP"	operate entrance
totalFee	decimal	Y	minimum unit: 0.01, minimum equivalent value: 0.5 USD	order amount
currency	string	Y	only crypto token accepted, fiat NOT supported.	order currency, e.g. "BUSD"
productType	string	Y	maximum length 16	product type
productName	string	Y	maximum length 256	product name
productDetail	string	N	maximum length 256	product detail
returnUrl	string	N	maximum length 256	redirect url

Sample Request Body

{  "merchantId": "98765987",  "subMerchantId": "98765987",  "merchantTradeNo": "9825382937292",  "totalFee": 25.17,  "productDetail": "Greentea ice cream cone",  "currency": "EUR",  "returnUrl": "",  "tradeType": "APP",  "productType": "Food",  "productName": "Ice Cream"}

Response Parameters

Attributes	Type	Required	Limitation	Description
status	string	Y	"SUCCESS" or "FAIL"	status of the API request
code	string	Y	-	request result code, refer to
data	OrderResult	Y	-	response body, refer to
errorMessage	string	Y	-

Child Attribute

OrderResult

Attributes	Type	Required	Limitation	Description
prepayId	string	Y	-	unique id generated by binance
tradeType	string	Y	"WEB", "APP"	operate entrance
expireTime	long	Y	-	expire time in milli seconds
qrcodeLink	string	Y	-	qr code img link
qrContent	string	Y	-	qr contend info

Sample Response

{  "status": "SUCCESS",  "code": "000000",  "data": {    "prepayId": "29383937493038367292",    "tradeType": "APP",    "expireTime": 121123232223,    "qrcodeLink": "https://qrservice.dev.com/en/qr/dplkb005181944f84b84aba2430e1177012b.jpg",    "qrContent": "https://qrservice.dev.com/en/qr/dplk12121112b"  },  "errorMessage": ""}

Result Code

Name	Code	Reason	Solution
UNKNOW_ERROR	400000	An unknown error occurred while processing the request.	Try again later
INVALID_REQUEST	400001	Parameter format is wrong or parameter transferring doesn't follow the rules.	Please check whether the parameters are correct.
INVALID_SIGNATURE	400002	Incorrect signature result	Check whether the signature parameter and method comply with signature algorithm requirements.
INVALID_TIMESTAMP	400003	Timestamp for this request is outside of the time window.	Sync server clock
INVALID_API_KEY_OR_IP	400004	API identity key not found or invalid.	Check API identity key
BAD_API_KEY_FMT	400005	API identity key format invalid.	Check API identity key.
MANDATORY_PARAM_EMPTY_OR_MALFORMED	400100	A parameter was missing/empty/null, or malformed.
INVALID_PARAM_WRONG_LENGTH	400101	A parameter was not valid, was empty/null, or too long/short, or wrong format.
INVALID_PARAM_WRONG_VALUE	400102	A parameter was not valid, the value is out of range.
INVALID_PARAM_ILLEGAL_CHAR	400103	A parameter was not valid, contains illegal characters
INVALID_REQUEST_TOO_LARGE	400104	Invalid request, content length too large
INVALID_MERCHANT_TRADE_NO	400201	merchantTradeNo is invalid or duplicated
ORDER_NOT_FOUND	400202	Order not found.
INVALID_ACCOUNT_STATUS	400203	Not support for this account, please check account status.
SUB_MERCHANT_INVALID	400206	The sub merchant does not exist or is in an unavailable state.