4.1.2.3 转账异步通知

正式环境

https://openapi.3ypay.com

POST

商户异步预留地址

当贵司接收到我司异步通知后请返回http状态码为200，其他状态码系统将判定为通知失败，将会触发重复通知队列，重复通知最大通知次数为20次，第一次重复通知将间隔50秒，后续每一次重复通知按照（通知次数*50）间隔时间进行通知

重要注意事项：请注意异步通知的转账订单状态，可能出现提交单笔转账申请后，异步通知一次，转账状态为3或其他值，如贵司未按照系统要求返回http状态码为200，系统将触发重复通知策略，可能会导致该笔转账订单成功后又发送一次转账状态为4，届时将会有两个线程同时向您的异步地址发送转账状态为3和转账状态为4的通知，请一定注意正确处理，状态优先级设定等情况避免将转账订单设置为成功后又设置为转账中或其他值的情况

请求参数

Body 参数application/json必填

示例

{
    "code": 0,
    "msg": "string",
    "appId": "string",
    "signType": "string",
    "timestamp": 0,
    "sign": "string",
    "data": {
        "mch_order_no": "string",
        "out_biz_no": "string",
        "batch_no": "string",
        "trans_amount": 0,
        "timestamp": "string",
        "account_book_id": "string",
        "channel_sn": "string",
        "agreement_no": "string",
        "product_code": "string",
        "order_title": "string",
        "payee_info": {
            "identity_type": "string",
            "name": "string",
            "identity": "string",
            "bankcard_ext_info": {
                "account_type": "string",
                "inst_name": "string",
                "inst_province": "string",
                "inst_city": "string",
                "inst_branch_name": "string",
                "bank_code": "string"
            }
        },
        "remark": "string",
        "business_params": {
            "payer_show_name_use_alias": true,
            "withdraw_timeliness": "string",
            "payer_show_name": "string"
        },
        "status": "string",
        "order_id": "string",
        "pay_fund_order_id": "string",
        "fail_reason": "string",
        "fee_rate": "string",
        "fee_amount": "string",
        "client_ip": "string",
        "trans_date": "string"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.3ypay.com商户异步预留地址' \
--header 'Content-Type: application/json' \
--data '{
    "code": 0,
    "msg": "string",
    "appId": "string",
    "signType": "string",
    "timestamp": 0,
    "sign": "string",
    "data": {
        "mch_order_no": "string",
        "out_biz_no": "string",
        "batch_no": "string",
        "trans_amount": 0,
        "timestamp": "string",
        "account_book_id": "string",
        "channel_sn": "string",
        "agreement_no": "string",
        "product_code": "string",
        "order_title": "string",
        "payee_info": {
            "identity_type": "string",
            "name": "string",
            "identity": "string",
            "bankcard_ext_info": {
                "account_type": "string",
                "inst_name": "string",
                "inst_province": "string",
                "inst_city": "string",
                "inst_branch_name": "string",
                "bank_code": "string"
            }
        },
        "remark": "string",
        "business_params": {
            "payer_show_name_use_alias": true,
            "withdraw_timeliness": "string",
            "payer_show_name": "string"
        },
        "status": "string",
        "order_id": "string",
        "pay_fund_order_id": "string",
        "fail_reason": "string",
        "fee_rate": "string",
        "fee_amount": "string",
        "client_ip": "string",
        "trans_date": "string"
    }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{}

4.1.2.2 单笔转账查询

4.1.2.4 转账回单申请