代付订单创建

特别声明

因网络请求的不稳定性，代付订单发起时，若无明确的错误返回 (如响应超时，请求中断，服务异常等与业务状态无关的情况)，需要在商户管理后台或通过查询接口二次核验订单状态，若订单存在且状态为"生成订单"和“交易异常”，则当前订单暂处于进行中状态，SimplyPay 团队将会人工参与进行后续确认，请不要对订单中的提现信息进行二次提现操作，以避免不必要的资金损失。

请求参数

Body 参数application/json

appId

string

应用号

必需

merOrderNo

string

商户订单号

必需

currency

string

金额币种

必需

3位字符

amount

string

金额

必需

notifyUrl

string

异步通知地址

必需

extra

object

扩展信息

必需

payoutType

string

代付类型

必需

固定值[IFSC]

ifsc

string

IFSC

可选

代付类型为 IFSC 则必填

account

string

收款账号

必需

代付类型为 IFSC 填银行收款账号

name

string

客户名称

必需

string

客户邮箱

必需

mobile

string

客户手机

必需

attach

string

附加信息

必需

附加信息，原样返回

sign

string

签名

必需

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢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

描述信息

必需

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

sign

string

签名

必需

attach

string

附加信息

必需

extra

object

必需

msg

string

返回文字描述

必需

示例

{
    "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"
    }
}

特别声明#

请求参数

示例代码

返回响应

特别声明