Payment Order Create - Simply Pay (English)

Request

Body Params application/json

appId

string

appid

required

merOrderNo

string

Merchant order number

required

currency

string

Amount in Currency

required

3 characters

amount

string

Order amount

required

Retain 2 decimal places (if invalid decimal places like .00, .0 are to be retained, please convert to string format to avoid inconsistent signature data)

returnUrl

string

Synchronized notification address

optional

notifyUrl

string

asynchronous notification address

required

attach

string

Additional Info

required

Merchant additional information, return as is

sign

string

sign

required

extra

object

required

name

string

required

email

string

required

mobile

string

required

Example

{
    "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": "发起代收"
}

Request samples

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": "发起代收"
}'

Responses

🟢200success

application/json

Body

code

integer

Response Status Code

required

0 for success

data

object

Return Data

required

orderStatus

integer

Order status

required

pending: 0,1,-4
success: 2,3
failed: -1,-2
refunded: -3

orderNo

string

Trade Order Number

required

merOrderNo

string

Merchant order number

required

amount

number

Order amount

required

currency

string

Amount in Currency

required

createTime

integer

required

updateTime

integer

required

message

string

Descriptive Information

required

This field is returned in case of order exceptions and is used as an exception description.

params

object

required

Payment data

sign

string

sign

required

msg

string

Return to text description

required

Example

{
    "code": 0,
    "msg": "success",
    "data": {
        "orderStatus": 1,
        "orderNo": "b7c9bd812dc846a08a0263a96a0c7af1",
        "merOrderNo": "s1711871776008",
        "amount": 200,
        "currency": "INR",
        "attach": "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?ver=01&mode=15&am=200.00&mam=200.00&cu=INR&pa=silicon.appxperts@timecosmos&pn=APPXPERTSPRIVATELIMITED&mc=5816&tr=SILICON1723304473EWFV134314&tn=bd4485c3fbb04cda8af373a19481700d&mid=SILIC4827&msid=APPX-6155&mtid=SILIC-4827"
        }
    }
}