OnlinePay API

Alipay

POSThttps://pay.online.ai/payment

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

请求参数

Header Params

paymentType

string

required

Fixed value: ALIPAY

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

Please refer to Currency Code

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

<= 64 characters

version

string

required

V3.0.0

<= 6 characters

userId

string

required

Payment user ID

string

required

Payment user Email

<= 100 characters

osType

string

required

Mobile system， Mobile system IOS or ANDROID

terminal

string

required

Terminal， WEB: indicates that a PC browser is used.WAP: indicates that a mobile browser is used.APP: indicates that a mobile app is used.MINI_APP: indicates that a mini program is used

{
  "merNo": 111111,
  "merOrderNo": "222222",
  "currencyCode": "CNY",
  "sourceAmount": "100.05",
  "returnUrl": "https://example.com",
  "notifyUrl": "https://example.com/notify",
  "sign": "9D6FDF4880B00B002B1F2AB61AE9A721",
  "ipAddress": "116.235.134.86",
  "version": "V3.0.0",
  "userId": "111",
  "email": "example@gmail.com",
  "osType": "ANDROID",
  "terminal": "WAP"
}

示例代码

Responses

Success(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

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

{
  "code": "00000",
  "message": "SUCCESS",
  "data": {
    "payCode": 0,
    "tradeNo": "SN2201111806024151",
    "merOrderNo": "1641972507000",
    "payUrl": "http://abc.com/notify"
  }
}

Last modified: 2 年前