Cryptocurrency Payment - OnlinePay API

Note: OnlinePay background will obtain the referer of Http Header to verify the website source. The website source must be configured in the OnlinePay merchant background to pass the detection. If you do not access the interface through a browser, you need to actively add a referer

Request

Header Params

paymentType

string

required

Fixed value:CRYPTO

Body Params application/json

merNo

integer

required

Merchant Number, Unique identifier assigned to the merchant by the onlinepay payment platform when registering with onlinepay

merOrderNo

string

required

Merchant Order Number, Each order must be unique, and each merchant order number can only be submitted once within 1 second

currencyCode

string

required

USDT_TRC

sourceAmount

string

required

Total amount of the order, keep two decimals

returnUrl

string

required

Jump address after payment is completed,

<= 512 characters

notifyUrl

string

optional

When the payment is completed, the payment result will be sent to notifyUrl

<= 512 characters

sign

string

required

signature, MD5(merNo+merOrderNo+currencyCode+sourceAmount+PrivateKey)

ipAddress

string

required

Cardholder IP address

version

string

required

V3.0.0

userId

string

required

Payment user ID

string

required

Payment user Email

<= 100 characters

Example

{
  "merNo": 0,
  "merOrderNo": "string",
  "currencyCode": "string",
  "sourceAmount": "string",
  "returnUrl": "string",
  "notifyUrl": "string",
  "sign": "string",
  "ipAddress": "string",
  "version": "string",
  "userId": "string",
  "email": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

code

string

required

If the value is 0000, it will return success, other please refer to Error Code

message

string

required

Interface returns description

data

object

optional

Request response data

tradeNo

string

required

The flow number generated after each order payment (unique marker)

payCode

string

required

Payment status code(Where: 1 means payment failure, 0 means payment success, 2 means pending)

payUrl

string

required

If the paycode is 2, redirect to this address

merOrderNo

string

required

Corresponds to the [OrderNo] parameter of the order submission parameter

Examples

SuccessException

{
  "code": "00000",
  "message": "SUCCESS",
  "data": {
    "payCode": 0,
    "tradeNo": "333333",
    "merOrderNo": "222222",
    "payUrl": "0xabcdefg"
  }
}