代收代付回调请求示例

POST

/notifyUrl

代收代付订单状态变化回调通知商户的请求示例
平台会发送http请求商户创建订单传的notifyUrl，商户处理成功需要返回success字样，如果没有检测到成功，系统后面会在一定次数内重复通知商户

回调参数 " 除sign外，都需要参数签名 "，不同情况有些参数会没有或者多一些参数，请做好签名参数校验

如果接收到重复回调或者无需处理的回调，请返回success字样

请求参数

Body 参数application/json

code

enum<integer> <int32>

必需

响应码.正常:200,查询不到:404,失败:500,重复亲求:425

枚举值:

200404500

msg

string

必需

描述信息(不能做判断,以status为准)

示例值:

success

status

enum<string>

可选

订单状态，具体查看【代收代付查询订单】

枚举值:

0001020304

payUrl

string

代收支付链接

可选

示例值:

https://checkout.eplspay.com/?cid=expireAt%202022-07-19T14:28:11.652&sid=S202207181549087817064251392&amount=20.00&qrcode=000201010212268D1A7

endToEndId

string

可选

endToEndId

amount

string

订单金额(分)

可选

fee

string

手续费

可选

realPayAmount

string

实际付款金额(分)

可选

createTimeL

string

可选

订单创建Unix毫秒

orderId

string

平台订单id

可选

示例值:

S202207181549087817064251392

merchantOrderId

string

商户订单id

可选

示例值:

pay2342342343565234123

payType

enum<string>

可选

代收110,代付120

枚举值:

110120

sign

string

签名值

可选

示例值:

c60bac24be9381a43db34bfbf2df230d

traceId

string

追踪id

可选

示例值:

qfrdby455v34q23crv34t54ar23rmi85t7v1123e4

transferReceipt

string

可选

代付参数，如果商户传了会回调过去

示例

{
  "amount": "5000",
  "code": 200,
  "createTimeL": 1680334544698,
  "endToEndId": "e00360305202304010736c2009ae8cdd",
  "fee": "150",
  "merchantOrderId": "164774677175285280-6-WVDVe",
  "msg": "PAID",
  "orderId": "S110202304011642068212621467648",
  "payType": "110",
  "payUrl": "https://pay2.mtbtop1.com/s3/checkout-page/v3.html?cid=expireAt%202023-04-01T05:35:44.725466&sid=S110202304011642068212621467648&amount=50&qrcode=00020101021226790014br.gov.bcb.pix2557brcode.starkinfra.com/v2/92cde06bbe9e4a15a349756d2d24a6325204000053039865802BR5925Wudi%20pay%20Correspondente%20d6009Sao%20Paulo62070503***63045AE8",
  "realPayAmount": "5000",
  "sign": "674e8a79f04939a44fda447d4b13ca8c",
  "status": "01",
  "traceId": "i200,i200401ec75e3c58a5a40cdb874d30bedabcb5c"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/notifyUrl' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": "5000",
    "code": 200,
    "createTimeL": 1680334544698,
    "endToEndId": "e00360305202304010736c2009ae8cdd",
    "fee": "150",
    "merchantOrderId": "164774677175285280-6-WVDVe",
    "msg": "PAID",
    "orderId": "S110202304011642068212621467648",
    "payType": "110",
    "payUrl": "https://pay2.mtbtop1.com/s3/checkout-page/v3.html?cid=expireAt%202023-04-01T05:35:44.725466&sid=S110202304011642068212621467648&amount=50&qrcode=00020101021226790014br.gov.bcb.pix2557brcode.starkinfra.com/v2/92cde06bbe9e4a15a349756d2d24a6325204000053039865802BR5925Wudi%20pay%20Correspondente%20d6009Sao%20Paulo62070503***63045AE8",
    "realPayAmount": "5000",
    "sign": "674e8a79f04939a44fda447d4b13ca8c",
    "status": "01",
    "traceId": "i200,i200401ec75e3c58a5a40cdb874d30bedabcb5c"
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

成功示例异常示例

success

修改于 2023-07-06 14:54:46

商户查询余额

代收代付批量查询接口