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	Y	-	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.
merchantTradeNo	string	Y	letter or digit, no other symbol allowed	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	fiat or token	ISO 4217 currency code, or 3-letter crypto code
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	string	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 key not found or invalid.	Check api key
BAD_API_KEY_FMT	400005	Api key format invalid.	Check api 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.