代收订单创建 - Simply Pay

请求参数

Body 参数application/json

appId

string

应用号

必需

merOrderNo

string

商户订单号

必需

currency

string

金额币种

必需

3位字符

amount

string

订单金额

必需

保留2位小数（若需保留 .00, .0类无效小数位，请转换为字符串格式，避免签名数据不一致）

returnUrl

string

同步通知地址

可选

notifyUrl

string

异步通知地址

必需

attach

string

附加信息

可选

商户附加信息，原样返回

sign

string

签名

必需

extra

object

必需

name

string

客户姓名(使用真实用户信息，可以提高成功率)

必需

email

string

客户邮箱(使用真实用户信息，可以提高成功率)

必需

mobile

string

客户电话(使用真实用户信息，可以提高成功率)

必需

cashierTheme

string

收银台样式主题选择

可选

唤醒: qrBaseDefault/qrBase001
收银台地址 https://h5.simplypay.vip/payment/{{theme}}/dsdd7b356782a6724d5fac6a3352ba

例如:
qrBase001: https://h5.simplypay.vip/payment/qrBase001/dsdd7b356782a6724d5fac6a3352ba

示例

{
    "appId": "8d72e27d3c6126abc1c542a9bfc3f271",
    "merOrderNo": "s1711871776008",
    "notifyUrl": "http://localhost:8888/notify",
    "sign": "44c1112502c204bef55e818e499dd795061a120bea1457c0522b8f50f58f987a",
    "currency": "INR",
    "amount": "200",
    "extra": {
        "name": "akin",
        "email": "akin@gmail.com",
        "mobile": "9937239312"
    },
    "attach": "发起代收"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request POST '{{HOST}}/api/v2/payment/order/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "8d72e27d3c6126abc1c542a9bfc3f271",
    "merOrderNo": "s1711871776008",
    "notifyUrl": "http://localhost:8888/notify",
    "sign": "44c1112502c204bef55e818e499dd795061a120bea1457c0522b8f50f58f987a",
    "currency": "INR",
    "amount": "200",
    "extra": {
        "name": "akin",
        "email": "akin@gmail.com",
        "mobile": "9937239312"
    },
    "attach": "发起代收"
}'

返回响应

🟢200成功

application/json

Body

code

integer

响应状态码

必需

0为成功

data

object

返回数据

必需

orderStatus

integer

订单状态

必需

支付中 0 1 -4
支付成功 2 3
支付失败 -1 -2 -3

orderNo

string

交易订单号

必需

merOrderNo

string

商户订单号

必需

amount

number

必需

currency

string

金额币种

必需

createTime

integer

必需

updateTime

integer

必需

message

string

描述信息

可选

订单异常时会返回此字段，用作异常描述

params

object

支付数据

必需

sign

string

签名

必需

attach

string

必需

extra

object

必需

payTime

integer

必需

msg

string

返回文字描述

必需

示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "orderStatus": 1,
        "orderNo": "b7c9bd812dc846a08a0263a96a0c7af1",
        "merOrderNo": "s1711871776008",
        "amount": 200,
        "currency": "INR",
        "attach": "发起代收",
        "extra": {
            "name": "akin",
            "email": "akin@gmail.com",
            "mobile": "9937239312"
        },
        "createTime": 1711877080129,
        "updateTime": 1711877080129,
        "sign": "adba0b1ec07ebfca94689ca43dcbfce2f3818b13f878e76ce9341331a9071f11",
        "params": {
            "paymentLink": "https://h5.simplypay.vip/payment/b7c9bd812dc846a08a0263a96a0c7af1/",
            "deepLink": "upi://pay?am=150.00&cu=INR&mc=7407&mode=02&orgid=159002&pa=9677386789%40sbi&pn=BRAND+PUZZER&purpose=00&sign=MEUCIFVEc044SLJaMVyrsc06pgDA9e8NXtZOutCzMmVBABTHAiEAmg64kqOL0u3GWbvU8o8xRk1%2FZVljcBO6wmkpIjWruFc%3D&tn=ZT6An840&tr=30b7a7fb49c04883ae766ff699e1894d&url="
        }
    }
}