Introduction

Create order after user scan the QRcode.

Must useDecode QRcode before calling create order api.

API Description

Request Method:POST

Request Path:open/api/scan/payment

Parameters

Request Parameters

Parameter	Sign	Mandatory	Type	Length	Description
appId	Y	Y	string	64	AppId is unique for merchant
sign	N	Y	string	512	Sign
merchantOrderNo	Y	Y	string	64	Merchant order number (must be unique)
qrCode	Y	Y	string	512	QR Code string
amount	Y	Y	string	20	Order amount (unit as fiat currency, 1=1.00) PHP/BRL/ARS/PEN/BOB/COP: retains two digits VND: no retain decimals
currency	Y	Y	string	20	Fiat currency (unit of amount) `VND`/`PHP`/`BRL`/`PEN`/`ARS`/ `INR`/`COP`/`BOB`
userId	Y	Y	string	64	UserId is unique for user (email / phone number)
userIp	Y	Y	string	64	User IP address
email	N	Y	string	64	User email
feeType	Y	Y	string	32	Outer Buckle: `OUTER_BUCKLE` User Buckle:`USER_BUCKLE`
callbackUrl	Y	Y	string	128	The address receiving order webhook
customParam	N	N	object	1024	Custom fields

Example

{
    "appId": "TEST000001",
    "sign": "TEST000001",
    "merchantOrderNo": "11187",
    "amount": "100000",
    "currency": "VND",
    "feeType":"INNER_BUCKLE",
    "qrCode": "00020101021138580010A000000727012800069704070114190360421800120208QRIBFTTA53037045802VN830084006304EDC5",
    "userId": "[email protected]",
    "userIp": "14.232.142.199",
    "email": "[email protected]",
    "callbackUrl": "http://127.0.0.1:8022/open/api/callback",
    "customParam": {}
}

Response Parameters

Parameter	Type	Description
success	boolean	Success
error	boolean	Error
code	long	Response code
msg	string	Response message
traceId	string	Trace id
model	object	Response content

Model Response Parameters

Parameter	Type	Description
amount	string	Order amount (USDT) retains two digits
orderNo	string	Order number

Example

{
    "code": "0",
    "msg": "success",
    "model": {
        "amount": 0.78,
        "orderNo": "400017452047901950404"
    },
    "traceId": "6805b6349f57da09af484497f3ea6136",
    "error": false,
    "success": true
}