付款

POST

/api/v2/merch/pay/apply

付款/提现

计算付款/提现手续费等, 如果需要换汇则会返回汇率

请求参数

Header 参数

X-Merch-Id

string

可选

默认值:

M24061911365700670

Body 参数application/json

request_id

string

请求id

必需

amount

integer <int64>

必需

付款金额(币种最小单位)

>= 1

currency

enum<string>

必需

币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元, SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币

枚举值:

EURUSDCNYGBPJPYAUDCADSGDHKDPHPCNH

beneficiary_id

string

收款人id

必需

>= 0 字符<= 32 字符

postscript

string | null

附言

可选

<= 64 字符

示例

{
    "request_id": "string",
    "amount": 1,
    "currency": "EUR",
    "beneficiary_id": "string",
    "postscript": "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/pay/apply' \
--header 'X-Merch-Id: M24061911365700670' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "string",
    "amount": 1,
    "currency": "EUR",
    "beneficiary_id": "string",
    "postscript": "string"
}'

返回响应

🟢200成功

*/*

Body

status

enum<string>

状态

必需

枚举值:

PROCESSINGSUCCEEDEDFAILED

fee_amount

integer <int64>

必需

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

beneficiary_type

enum<string>

收款人类型

必需

枚举值:

PAYWITHDRAW

示例

{
    "status": "PROCESSING",
    "fee_amount": 0,
    "beneficiary_type": "PAY"
}

🟠400请求有误

🟠401没有权限

🟠404记录不存在

🟠429429

🔴500服务器错误

修改于 2025-05-23 08:26:47

换汇结果通知

付款状态查询