4.2.2.1 统一支付接口

正式环境

https://openapi.3ypay.com

POST

/aqf-openapi/openapi/pay/create

重要

1. 在使用我司直连直付通服务时，务必保证每个收单结算企业的支付宝账户中可直接使用的余额超过100元人民币。请注意，此处仅指账户内实际可支配的现金余额，不包括余利宝、花呗等其他形式的资金或信用额度。此要求旨在确保能够顺利扣除由支付宝官方收取的相关手续费。若在执行分账操作时发现支付宝账户余额不足，则该笔交易将暂停资金结算流程，直至分账成功完成之后，方可继续进行后续的资金处理。
2. 对于金额低于1元人民币的订单，系统将不会对其进行任何形式的资金结算。只有当订单总金额达到或超过1元人民币时，相关财务结算程序才会被激活并执行。

请求参数

Body 参数application/json必填

示例

{
    "appId": "APP_02079797935",
    "timestamp": 1767513965886,
    "requestId": "37e17d976250aca644d1771946498988",
    "version": "1.0",
    "signType": "RSA2",
    "charset": "UTF-8",
    "bizContent": "{\"productCode\":\"Ali-PAY\",\"paySubType\":\"H5\",\"sceneType\":1,\"mchOrderNo\":\"39a895a233545533155\",\"orderAmount\":\"0.1\",\"subject\":\"adipisicing in laborum cupidatat proident\",\"attach\":\"adipisicing aute officia ea\",\"clientIp\":\"234.198.110.50\",\"description\":\"测试测试\",\"notifyUrl\":\"https://juicy-pear.info/\",\"redirectUrl\":\"https://charming-husband.net/\"}",
    "sign": "rHWMhLxLKmXvVEYYZMvwyA3xlPErOTEflSdb5JoolizNs1S6hRrm0HPJaDnCvp0Fw7y3LnNaslGUxjke/0U0qdPEQXcgUsthGmbHZ15gWOL1OrpPlEnEzR7wNKvywwgGwqoSl2+JeraFZHTbJ22B+1p8u5igDqFg8Fl9CWzkLc1JbIWQ/zzavJeE3LatdXZ2xgBFlyFWii1pafkUlAOhXgex4n2W7fMMaWcx+uGHtZJmyhpsJh/HP0U/xTkTinO04P9/WMHzooUMCPfni2fCsxWEgqtjL7G/dGbm3TONCndMRPO8jJ+p90b9m11XPifx9c+21myLwIOTVjSQiJzfcQ=="
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.3ypay.com/aqf-openapi/openapi/pay/create' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "APP_02079797935",
    "timestamp": 1767513965886,
    "requestId": "37e17d976250aca644d1771946498988",
    "version": "1.0",
    "signType": "RSA2",
    "charset": "UTF-8",
    "bizContent": "{\"productCode\":\"Ali-PAY\",\"paySubType\":\"H5\",\"sceneType\":1,\"mchOrderNo\":\"39a895a233545533155\",\"orderAmount\":\"0.1\",\"subject\":\"adipisicing in laborum cupidatat proident\",\"attach\":\"adipisicing aute officia ea\",\"clientIp\":\"234.198.110.50\",\"description\":\"测试测试\",\"notifyUrl\":\"https://juicy-pear.info/\",\"redirectUrl\":\"https://charming-husband.net/\"}",
    "sign": "rHWMhLxLKmXvVEYYZMvwyA3xlPErOTEflSdb5JoolizNs1S6hRrm0HPJaDnCvp0Fw7y3LnNaslGUxjke/0U0qdPEQXcgUsthGmbHZ15gWOL1OrpPlEnEzR7wNKvywwgGwqoSl2+JeraFZHTbJ22B+1p8u5igDqFg8Fl9CWzkLc1JbIWQ/zzavJeE3LatdXZ2xgBFlyFWii1pafkUlAOhXgex4n2W7fMMaWcx+uGHtZJmyhpsJh/HP0U/xTkTinO04P9/WMHzooUMCPfni2fCsxWEgqtjL7G/dGbm3TONCndMRPO8jJ+p90b9m11XPifx9c+21myLwIOTVjSQiJzfcQ=="
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

成功示例失败示例（业务层异常）1失败示例（业务层异常）2失败示例（业务层异常）3失败示例（网关层拦截）4

{
    "appId": "APP_02079797935",
    "code": 200,
    "data": "{\"payOrderNo\":\"P202601041606082320\",\"paySubType\":\"H5\",\"mchOrderNo\":\"39a895a233545533155\",\"subject\":\"adipisicing in laborum cupidatat proident\",\"description\":\"测试测试\",\"payAmount\":\"0.1\",\"productCode\":\"Ali-PAY\",\"failReason\":\"\",\"payDataType\":\"payUrl\",\"state\":2,\"payInfo\":\"https://openapi.alipay.com/gateway.do?method=alipay.trade.wap.pay&app_id=2021004114607108&timestamp=2026-01-04+16%3A06%3A08&format=json&version=1.0&alipay_sdk=alipay-easysdk-php-2.2.3&charset=UTF-8&sign_type=RSA2&app_cert_sn=&alipay_root_cert_sn=&biz_content=%7B%22subject%22%3A%22adipisicing+in+laborum+cupidatat+proident%22%2C%22out_trade_no%22%3A%22P202601041606082320%22%2C%22total_amount%22%3A%220.1%22%2C%22quit_url%22%3A%22%22%2C%22product_code%22%3A%22QUICK_WAP_WAY%22%2C%22sub_merchant%22%3A%7B%22merchant_id%22%3A%222088280014673313%22%7D%2C%22request_from_url%22%3A%22%22%2C%22settle_info%22%3A%7B%22settle_period_time%22%3A%22180+d%22%2C%22settle_detail_infos%22%3A%5B%7B%22trans_in_type%22%3A%22defaultSettle%22%2C%22amount%22%3A%220.1%22%7D%5D%7D%7D&return_url=https%3A%2F%2Fcharming-husband.net%2F&notify_url=http%3A%2F%2F23mn3et52997.vicp.fun%2Fapi%2Freport.notify%2FalipayNotify&sign=dbbDiQrqChpsshnIVaEOgFINBb75rSTE6BLZO1UbwhtrcdJKDLczP9gEF4cgaaBo4IGX83AJD57fmRQBRYZOrwKl9t1TvNKohEfqtazEEI0Y4tOVnWVaHXXYOfXAmRvriX9VRQA7MP0SOIc8ctUkwOWkJl2Ts%2B9Rn8ANZxVFg%2Bzk9fS7qDXavRvx%2BsMrs9HyVH01ximhF%2FSD13Zw6Zy4reZ%2FnwybmYjwmNL8RmvAyGhLZ8Fgk0bMseDI04gXw2HgnWGfpxwhTR0MkftP34XTxybO78JKt1dBFWD0srj8t%2BxpQePzSJ53WsEhN%2FXIjgBydmg%2FCBz9QiKj0AWV8HPSvQ%3D%3D\",\"channelSn\":\"ZFT202512271813437006\"}",
    "msg": "请求成功",
    "sign": "K6ZrrHT6Zj+KwrWTzYCWZXn/5cWJ/DJldLKOMFCuPlad3/1GlKXtOktphdTRsIbOUhIX8s5KwAlbGqiLNDFUKP7ZTgB7o9hvgUF8ERmmqSeV/Hnv4quKGh0cv5MYKfyOZftYs1DQum/FJcKTcD5zeA9Pun9FeYmisvJx2iy+5/phjEA6/G3ZTQIfG6QbZTX614JCAcB2JnfaNzChMpWMbCTgfEKgRT1//JoO/AYphmTkKgVLmFMTRWLNzHiMnvf8TBmVIi3BGvaPXPSbG2Troe0EIPiN3rA+rppMmfkLMiyuQoVeNVqD8l34ep9oTpbGKzRLrVDX+xfwfqrP+v9pFw==",
    "signType": "RSA2",
    "timestamp": 1767513968939
}

4.1.2.5 转账回单下载

4.2.2.2 统一交易查询