收款人创建结果(通知)

POST

/api/v2/merch/beneficiary/notify

收款人v2

收款人创建结果(通知)

请求参数

Header 参数

X-Merch-Id

string

可选

默认值:

M24061911365700670

Body 参数application/json

type

enum<string>

必需

业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款, CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人, WD_ACCOUNT-提现账户, CUR_EXCHANGE-换汇, PAYMENT-付款

枚举值:

MERCHVAINCOMING_REMITTANCECONTRACT_ORDERTRADE_SETTLEPAYEEWD_ACCOUNTFOREXPAYMENT

version

string

必需

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

data

object

业务数据

必需

request_id

string

必需

请求号，请求方系统内唯一

>= 1 字符<= 32 字符

merch_id

string

商户id

必需

>= 1 字符<= 20 字符

type

string

必需

目的(必填): PAYMENT-收款、WITHDRAWAL-提现

payee_id

string

收款人id

必需

>= 1 字符<= 20 字符

status

enum<string>

必需

付款人审核状态 PENDING-待审核 NORMAL-正常 REJECTED-审核未通过 DELETED-已删除

枚举值:

PENDINGNORMALREJECTEDDELETED

msg

string

可选

结果说明，失败时不为空

示例

{
    "type": "MERCH",
    "version": "string",
    "data": {
        "request_id": "string",
        "merch_id": "string",
        "type": "string",
        "payee_id": "string",
        "status": "PENDING",
        "msg": "string"
    }
}

示例代码

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/beneficiary/notify' \
--header 'X-Merch-Id: M24061911365700670' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "MERCH",
    "version": "string",
    "data": {
        "request_id": "string",
        "merch_id": "string",
        "type": "string",
        "payee_id": "string",
        "status": "PENDING",
        "msg": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

🟠400请求有误

🟠401没有权限

🟠404记录不存在

🟠429429

🔴500服务器错误

修改于 2024-12-03 06:44:21

收款人创建结果查询

换汇预下单(询价)