API used to create authorization request to your merchant. *This API is only available for
Technical Service Provider (TSP), for more information please contact us at: [email protected]
EndPoint
POST /binancepay/openapi/service/provider/create
Request Parameters
Attributes Type Required Limitation Description merchantId string Y merchant id scopes List Y Scopes ipWhitelist List Y IP Whitelist
Sample Request Body
{ "merchantId" : "merchant1" , "scopes" : [ "CONVERT" , "CHECKOUT" ], "ipWhitelist" : [ "192.168.1.1" , "192.168.1.2" ] }
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 DataObject N - response body, refer to errorMessage string N maximum length 256
Child Attribute
DataObject
Attributes Type Required Limitation Description authorizationId String Y Authorization ID merchantName String Y Merchant's Name authorizationToken String Y Authorization Token merchantId String Y Merchant's ID status String Y Status redirectUrl String Y redirect url to bring merchant to mmp agree page scopes List Y Scopes ipWhitelist List Y IP Whitelist
Sample Response
{ "status" : "SUCCESS" , "code" : "000000" , "data" : { "authorizationId" : "authId1" , "merchantName" : "Merchant One" , "authorizationToken" : "token1" , "merchantId" : "merchant1" , "status" : "PENDING" , "redirectUrl" : "https://merchant.binance.com/en/dashboard/review-authorization?authId=authId1" , "scopes" : [ "CONVERT" , "CHECKOUT" ], "ipWhitelist" : [ "192.168.1.1" , "192.168.1.2" ] } }
{ "status" : "FAIL" , "code" : "400003" , "errorMessage" : "Timestamp for this request is outside of the recvWindow." }
Result Code
Name Code Reason Solution UNKNOWN_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. BAD_HTTP_METHOD 400006 Request method not supported. Check Request method. MEDIA_TYPE_NOT_SUPPORTED 400007 Media type not supported. Check Request Media type. INVALID_REQUEST_BODY 400008 Request body is not a valid json object. Check Request body 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_ID 406210 Invalid merchant id
Last modified on July 7, 2026
