Create Order(USD)

Introduction

Create order for USD bank-account based transactions.

API Description

Request Method:POST

Request Path:open/api/transfer/payment

Parameters

Request Parameters

ParameterSignMandatoryTypeLengthDescription
appIdYYstring64AppId is unique for merchant
signNYstring512Sign
merchantOrderNoYYstring64Merchant order number (must be unique)
amountYYstring20Order amount (unit as fiat currency, 1=1.00)
currencyYYstring20Fiat currency (unit of amount, support USD)
emailNYstring64User email
userIdYYstring64Email/ Phone number
userIpYYstring64User IP
feeTypeYYstring32Outer buckle(user afford fee): OUTER_BUCKLE
callbackUrlYYstring128The address receiving order webhook
bankParamNNobject1024Bank account expend parameter
customParamNNobject1024Custom fields
remarkNNstring1024Remark

USD customParam Expend Parameter:

ParameterSignMandatoryTypeLengthDescription
bankCodeYYString32Bank code, refers to Bank Transfer Account Form api response

Request Parameter Example

{
    "appId": "TEST000001",
    "sign": "TEST000001",
    "merchantOrderNo": "12365124789",
    "amount": "15",
    "currency": "USD",
    "feeType": "INNER_BUCKLE",
    "userId": "[email protected]",
    "userIp": "14.232.142.199",
    "callbackUrl": "http://127.0.0.1:8022/open/api/callback",
    "bankParam": {
        "XXXXX": "XXXXX"
    }
}

Response Parameters

ParameterTypeDescription
successbooleanSuccess
errorbooleanError
codelongResponse code
msgstringResponse message
traceIdstringTrace id
modelobjectResponse content

Response Parameter Example

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

USD Payment Limit

For more details,please check Supported Merchant List

Brand NameStatusPayment Limit
InstacartY$25 - $250
adidasY$5 - $250
LOFTY$1 - $500
ColumbiaY$5 - $500
HomeGoodsY$5 - $500
Macy'sY$10 - $500
The Home DepotY$15 - $2,000
CVS PharmacyY$10 - $500
AppleY$10 - $500
StarbucksY$10 - $500
TargetY$10 - $2,000
WalmartY$10 - $500
NikeY$5 - $500
IKEAY$25 - $500
T.J.MaxxY$10 - $500