汇入汇款(通知)

POST

/api/v2/remittance/notify

汇入汇款

type=INCOMING_REMITTANCE

请求参数

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

业务数据

必需

merch_id

string

收款商户id

必需

>= 1 字符<= 20 字符

order_no

string

必需

paykka收款单号

>= 1 字符<= 32 字符

amount

integer <int64>

必需

汇入汇款金额(币种最小单位)

currency

enum<string>

必需

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

枚举值:

EURUSDCNYGBPJPYAUDCADSGDHKDPHPCNH

payer

string

付款人

可选

payment_account

string

付款账号

可选

payer_bank_bic

string

付款银行BIC

可选

payer_bank_name

string

付款人银行名称

可选

payee

string

收款人

可选

recv_account

string

收款账号

必需

recv_time

string <date-time>

收款时间

必需

remark

string

附言

可选

示例

{
    "type": "MERCH",
    "version": "string",
    "data": {
        "merch_id": "string",
        "order_no": "string",
        "amount": 0,
        "currency": "EUR",
        "payer": "string",
        "payment_account": "string",
        "payer_bank_bic": "string",
        "payer_bank_name": "string",
        "payee": "string",
        "recv_account": "string",
        "recv_time": "2019-08-24T14:15:22Z",
        "remark": "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/remittance/notify' \
--header 'X-Merch-Id: M24061911365700670' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "MERCH",
    "version": "string",
    "data": {
        "merch_id": "string",
        "order_no": "string",
        "amount": 0,
        "currency": "EUR",
        "payer": "string",
        "payment_account": "string",
        "payer_bank_bic": "string",
        "payer_bank_name": "string",
        "payee": "string",
        "recv_account": "string",
        "recv_time": "2019-08-24T14:15:22Z",
        "remark": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

🟠400请求有误

🟠401没有权限

🟠404记录不存在

🟠429429

🔴500服务器错误

修改于 2024-12-03 07:27:15

收款账号开通结果(通知)

订单创建