付款结果通知

POST

/api/v2/merch/pay/notify

付款/提现

付款结果通知

请求参数

Header 参数

X-Merch-Id

string

可选

默认值:

M24061911365700670

Body 参数application/json

type

string

必需

version

string

必需

版本号(V1、V2、...)

data

object

必需

request_id

string

必需

status

enum<string>

状态

必需

枚举值:

PROCESSINGSUCCEEDEDFAILEDRETURNED

fee_amount

integer

必需

手续费(币种为付款货币，该币种最小单位)

beneficiary_type

enum<string>

收款人类型

必需

枚举值:

PAYWITHDRAW

merch_id

string

商户id

必需

>= 1 字符<= 20 字符

示例

{
  "type": "MERCH",
  "data": {
    "request_id": "123",
    "status": "ENABLED",
    "fee_amount": 123,
    "beneficiary_type" : "sss"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open-fat.cb.paykka.com/api/v2/merch/pay/notify' \
--header 'X-Merch-Id: M24061911365700670' \
--header 'Content-Type: application/json' \
--data-raw '{
  "type": "MERCH",
  "data": {
    "request_id": "123",
    "status": "ENABLED",
    "fee_amount": 123,
    "beneficiary_type" : "sss"
  }
}'

返回响应

🟢200成功

text/plain

Body

status

enum<string>

状态

必需

枚举值:

PROCESSINGSUCCEEDEDFAILED

fee_amount

integer <int64>

必需

手续费(币种为付款货币)

beneficiary_type

enum<string>

收款人类型

必需

枚举值:

PAYWITHDRAW

🟠400请求有误

🟠401没有权限

🟠404记录不存在

🟠429429

🔴500服务器错误

修改于 2025-05-23 08:27:50

付款状态查询

文件上传接口参数说明