Create Order
Description
Create order
MUST Keep the orderNo from response, it is uniquely identifies for order query.
Path
POST open/api/payment
Parameters
Request parameters
Parameter | Sign | Mandatory | Type | Length | Remarks |
|---|---|---|---|---|---|
appId | Y | Y | string | 64 | AppId is uniqle for merchant |
sign | N | Y | string | 256 | Sign |
merchantOrderNo | Y | Y | string | 64 | Customer transaction ID, only number |
orderAmount | Y | Y | string | 64 | Order amount (amount unit: cent) |
payCurrency | Y | Y | string | 64 | Currency of payment (EUR / USD) |
userId | Y | Y | string | 128 | UserId is uniqle for user (email / phone number) |
paymentExchange | Y | N | string | 512 | Exchange Code and Wallet Code
|
paymentTokens | Y | N | string | 128 |
|
redirectURL | N | N | string | 512 | The redirection address after the successful purchase |
callbackURL | N | N | string | 512 | The address receiving order webhook |
customParam | N | N | string | 512 | Merchant custom parameters |
expiredTime | N | N | string | 32 | Time of expire (second) |
payType | N | N | string | 32 | Type of payment |
paymentNetworks | N | N | string | 32 | Specify payment network(separated by comma) |
orderModel | N | N | string | 32 | Order mode (ORDER/RECHARGE) capital letter required |
Payment Methods
| Payment Method | Payment Method Code |
|---|---|
| QR Code Payment | WALLET |
| Exchange | EXCHANGE |
| Binance Pay | BINANCE_PAY |
| Wallet Payment | MESH_WALLET |
Supported payCurrency:
| Currency | Regular | Example |
|---|---|---|
| USD | 2 non-zero decimal places after the decimal point | 100.12 |
| EUR | 2 non-zero decimal places after the decimal point | 100.12 |
| HKD | 2 non-zero decimal places after the decimal point | 100.12 |
| IDR | integer | 1000 |
| THB | integer | 1000 |
| VND | integer | 1000 |
Supported Token
| Crypto | Network |
|---|---|
| USDT | TRX,BSC,ETH,SOL |
| USDC | TRX,BSC,ETH,SOL |
| ETH | ETH,BSC |
| BTC | BTC |
| PCI | ETH,PCI |
| TON | TON |
Exchange Code
| Exchange | Code |
|---|---|
| Kraken | 16f021b0-f220-4bbb-aa3b-82d423301957 |
| Paxos | 2fdd678d-8ece-49f5-992c-a1d7c4367833 |
| Bybit | 3b8d8911-b2c0-4c1a-9127-675653c21960 |
| Coinbase | 47624467-e52e-4938-a41a-7926b6c27acf |
| Robinhood | 6e192ebb-a073-4055-bbd7-d644539c9a20 |
| Binance | 9226e5c2-ebc3-4fdd-94f6-ed52cdce1420 |
Wallet Code
| Wallet | Code |
|---|---|
| Metamask | 34aeb688-decb-485f-9d80-b66466783394 |
| Trust Wallet | 7f4307ea-58c6-4678-9eb2-fec205de5401 |
| Coinbase Wallet | 6132432e-d59c-4555-9844-cea0ce600ba3 |
| Uniswap Wallet | 58c89cae-b2ff-4176-85a3-1d1f7795cbe0 |
| Blockchain Wallet | d22f63a1-50c0-4439-961c-870fc430c979 |
| Bitcoin.com Wallet | f4b147b5-d166-4e6e-b4c1-e59d401cde11 |
| Crypto.com Wallet Prime | e16f1dc8-7577-4170-a67f-5ebb266e410e |
| imToken | 7f523342-0bc6-4465-a035-bb4d2ed693ed |
| Rainbow | 8a60d227-2825-4158-b14b-3c8443a2b681 |
Request Example
{
"appId": "TEST000001",
"callbackURL": "https://90fc-111-10-154.ngrok-free.app/v1/xxxxx",
"expiredTime": "60",
"merchantOrderNo": "17236123450000",
"orderAmount": "100",
"orderModel": "ORDER",
"payCurrency": "USD",
"paymentTokens": "ETH",
"redirectURL": "https://50xxxxx832.vicp.fun/platform/xxxxx",
"sign": "07572BA8F945685E6BB57FC21FDE74E7217A015E00FD56176F3A500465817B33FAC086DA7887AC266BA8518960F0FE208DE1A8E105978B185A8D136DD0F6",
"userId": "[email protected]"
}Description of Response Parameters
| Parameter | Type | Details |
|---|---|---|
| success | boolean | Success |
| error | boolean | Error |
| code | long | Response code |
| msg | string | Response message |
| traceId | string | Trace id |
| model | object | Response details |
| checkout address | string | checkout web address |
Response Example
{
"code": "0",
"model": {
"orderNo": "300217236173748123456",
"webUrl": "https://crypto-payment.alchemypay.org?orderNum=30012345678923456"
},
"msg": "success",
"traceId": "66bc505e9f97eafb6ca69d123471cb"
}Response Code
| Code | Explain |
|---|---|
| 0 | Success |
| 1 | Payment abnormality |
| 8000 | Parameter validation error |
| 8003 | Content-type should be application/json |
| 8004 | Request parameter format is incorrect. It needs to be JSON. |
| 8007 | Signature error |
| 8011 | Repeat merchantOrderNo |
| 8012 | Illegal IP |
| 8013 | Unsupported Crypto |
Updated about 1 month ago