Skip to main content

OAuth API : Create Collection

Query c2c supported currencies.

  • The host of OAuth API is https://accounts.binance.com
  • The request parameter of OAuth API is transferred as query string of requested url.
  • No need to add signature and API identity key to request header of OAuth API.
POST https://accounts.binance.com/oauth-api/v1/pay/c2c/collection/create

Parameters(Query String of Requested URL):#

NameTypeMandatoryDescription
access_tokenStringYES
amountBigDecimalYEScollection order amount
currencyStringYEScollection order currency
descriptionString(50)NOcollection order note
clientTradeNoString(32)YEStrade no in client system, used as idempotent check
clientUserIdString(32)NOuser id in client system
clientUserMobileString(32)NOuser mobile in client system
notificationUrlStringNOurl for collection order status notification

Response:#

NameTypeMandatoryDescription
codeStringYESwhen success=false, the value is the result code
messageStringNOwhen success=false, the value is error description
dataCreateCollectionOrderRespNOwhen success=true, the value is the create collection result, refer to CreateCollectionOrderResp
successbooleanYES

CreateCollectionOrderResp:#

NameTypeMandatoryDescription
orderIdStringYES
clientTradeNoStringYES
typeStringYEScollection order type, it always equals to pain text 'COLLECTION'
{  "code": "000000",  "message": null,  "data": {    "orderId": "12345",    "clientTradeNo": "re3432",    "type" : "COLLECTION"  },  "success": true}

Result Code#

NameCodeReason
PAYMENT_INVALID_CURRENCY403031Requested currency is not supported
PAYMENT_ILLEGAL_AMOUNT403040The amount is illegal, too small
PAYMENT_C2C_TRADE_NO_DUPLICATED403211clientTradeNo is duplicated
PAYMENT_RECEIVER_EXCEED_RECEIVE_LIMIT403706Recipient has exceeded fund receiving limit.