Simply Pay (English)
  1. payout
Simply Pay (English)
  • Access Guidelines
  • Accessory Code Table
  • Signature Example
  • Solutions to common problems with signatures
  • payment
    • Payment Order Create
      POST
    • Payment Order Query
      GET
  • payout
    • Payout Order Create
      POST
    • Payout Order Query
      GET
  • account
    • Balance Query
      GET
  • webhook
    • payment webhook
    • payout webhook
  1. payout

Payout Order Create

POST
{{HOST}}/api/v2/payout/order/create

Special announcement#

If the HTTP response status code is not 200 when the order is created and initiated, the order status must be verified twice through the merchant management background or the order inquiry interface. If the order exists and the status is "Generating Order" and "Transaction Abnormal", the current order is in the status of in-progress, so don't make any changes to the order. If the order exists and the status is "Generated Order" and "Transaction Exception", then the current order is in progress, so do not change any order, otherwise there may be unnecessary capital loss, so please be careful. If the business code returned by the creation interface is 400 and there is a clear parameter verification failure, you can directly determine the order failure without inquiry. If you have any questions, please confirm with the SimplyPay team at the first time, the query interface must be the order status (orderStatus) as the basis for order judgment, if any other abnormalities, please do not modify the order status, you need to manually participate in the SimplyPay team to follow up on the confirmation, please do not withdraw cash in the order of the withdrawal of information on the second withdrawal operation to avoid unnecessary loss of funds. avoid unnecessary loss of funds. Please do not withdraw your money twice to avoid unnecessary loss of funds.

Request

Body Params application/json
appId
string 
appid
required
merOrderNo
string 
Merchant Order Number
required
currency
string 
Amount 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)
notifyUrl
string 
asynchronous notification address
required
extra
object 
Extended Information
required
payoutType
string 
required
Fixed value 【IFSC】
ifsc
string 
required
account
string 
required
name
string 
required
email
string 
required
mobile
string 
required
attach
string 
Additional Information
required
Merchant additional information, return as is
sign
string 
sign (one's name with a pen etc)
required
Example
{
    "appId": "e98dfcdad34457e7b8a5f5a53ef5fc90",
    "merOrderNo": "s1711871776009",
    "currency": "INR",
    "notifyUrl": "http://localhost:8888/notify",
    "sign": "692d6c8be0a59cf3547a5b5230d2196487320378e6c120b6c9e46609f1aaad1f",
    "amount": "200",
    "extra": {
        "payoutType": "IFSC",
        "ifsc": "UTIB0001617",
        "account": "923010051550740",
        "name": "Savings Account",
        "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
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST '{{HOST}}/api/v2/payout/order/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "e98dfcdad34457e7b8a5f5a53ef5fc90",
    "merOrderNo": "s1711871776009",
    "currency": "INR",
    "notifyUrl": "http://localhost:8888/notify",
    "sign": "692d6c8be0a59cf3547a5b5230d2196487320378e6c120b6c9e46609f1aaad1f",
    "amount": "200",
    "extra": {
        "payoutType": "IFSC",
        "ifsc": "UTIB0001617",
        "account": "923010051550740",
        "name": "Savings Account",
        "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 
Transaction Order Number
required
merOrderNo
string 
Merchant Order Number
required
amount
integer 
Order Amount
required
currency
string 
Amount 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.
sign
string 
sign (one's name with a pen etc)
required
attach
string 
required
extra
object 
required
msg
string 
Return to text description
required
Example
{
    "code": 0,
    "msg": "success",
    "data": {
        "orderStatus": 1,
        "orderNo": "dc07e03f03b94e8a9f29702863d35fd5",
        "merOrderNo": "s1711871776009",
        "amount": 200,
        "currency": "INR",
        "attach": "发起代付",
        "extra": {
            "payoutType": "IFSC",
            "account": "923010051550740",
            "ifsc": "UTIB0001617",
            "name": "Savings Account",
            "email": "akin@gmail.com",
            "mobile": "9937239312"
        },
        "createTime": 1711979122245,
        "updateTime": 1711979122245,
        "sign": "ce91dafc3af8c358e22500e4486a36ff2383a259c5240b15374f49083e3213c8"
    }
}
Modified at 2025-02-28 15:29:26
Previous
Payment Order Query
Next
Payout Order Query
Built with