3.2.1 统一支付接口

正式环境

https://openapi.3ypay.com

POST

/openapi/order/pay/create

当 支付方式（paySubType） 为 用户扫码（NATIVE） 时仅支持支付宝与银联支付， 微信支付不支持！请自行调用JSAPI支付

当支付方式为JSAPI支付时并且为微信支付时，支付方式（extra）拓展属性中subAppId与userId必填，不允许为空

请求参数

Body 参数application/json必填

示例

{
    "appId": "APP_00789396918",
    "requestId": "8dc4ae185d505f450c3db4aae02bcbf0",
    "signType": "RSA2",
    "timestamp": 1768217324693,
    "version": "1.0",
    "charset": "UTF-8",
    "subSn": null,
    "sign": "BQUnvUrPzqSwQTOa4B/NCQmcJG97CveoYadkQG1LaK6bEj66E1jzcs+BaMzCNcQpLiRkfuQOTjpqexnZlD6o5lB6ltqlK35ajCq+/KyZczZ/SXpFHKyNNxPqGd678IfYzbl/QH/kXkKlX/oJGYKNiE01XuUzp6APEGH2VYqpsB7fRkhF0aA1/LomVEC8UF74wUxcuqG9E+eH0FSTz3SvC0zGHnsfvnFpjHA/xppfbc8ZBZhTiOEk4gpHkfdh164kSyq3WPQutbFRbEknAHCMk+ecc3qD8UowCEEnzucttVZNhTVR8e2tre3cab44jW6RV1B0N25FzPTRMsJK1ecNFA==",
    "bizContent": {
        "mchOrderNo": "088591a711a36268c5172ca85dfba36d",
        "productCode": "Ali-PAY",
        "paySubType": "NATIVE",
        "subject": "实用的软金枪鱼",
        "description": "圆滑的橡胶金枪鱼",
        "orderAmount": 69.39,
        "attach": "aute",
        "clientIp": "126.234.35.36",
        "notifyUrl": "https://fussy-exhaust.com",
        "redirectUrl": "https://baggy-devil.net",
        "cancelUrl": "https://sturdy-cod.org/",
        "expiredTime": 1750870882838,

        "sceneType": 2,
        "profitType": 93,

        "appChannelSn": "magna qui pariatur",
        "accessSn": "amet sint id",
        "channelCode": "57",
        "providerCode": "10",
        "autCode": "29"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.3ypay.com/openapi/order/pay/create' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "APP_00789396918",
    "requestId": "8dc4ae185d505f450c3db4aae02bcbf0",
    "signType": "RSA2",
    "timestamp": 1768217324693,
    "version": "1.0",
    "charset": "UTF-8",
    "subSn": null,
    "sign": "BQUnvUrPzqSwQTOa4B/NCQmcJG97CveoYadkQG1LaK6bEj66E1jzcs+BaMzCNcQpLiRkfuQOTjpqexnZlD6o5lB6ltqlK35ajCq+/KyZczZ/SXpFHKyNNxPqGd678IfYzbl/QH/kXkKlX/oJGYKNiE01XuUzp6APEGH2VYqpsB7fRkhF0aA1/LomVEC8UF74wUxcuqG9E+eH0FSTz3SvC0zGHnsfvnFpjHA/xppfbc8ZBZhTiOEk4gpHkfdh164kSyq3WPQutbFRbEknAHCMk+ecc3qD8UowCEEnzucttVZNhTVR8e2tre3cab44jW6RV1B0N25FzPTRMsJK1ecNFA==",
    "bizContent": {
        "mchOrderNo": "088591a711a36268c5172ca85dfba36d",
        "productCode": "Ali-PAY",
        "paySubType": "NATIVE",
        "subject": "实用的软金枪鱼",
        "description": "圆滑的橡胶金枪鱼",
        "orderAmount": 69.39,
        "attach": "aute",
        "clientIp": "126.234.35.36",
        "notifyUrl": "https://fussy-exhaust.com",
        "redirectUrl": "https://baggy-devil.net",
        "cancelUrl": "https://sturdy-cod.org/",
        "expiredTime": 1750870882838,

        "sceneType": 2,
        "profitType": 93,

        "appChannelSn": "magna qui pariatur",
        "accessSn": "amet sint id",
        "channelCode": "57",
        "providerCode": "10",
        "autCode": "29"
    }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

异常示例（业务层异常）异常示例（网关层拦截）成功示例异常示例（业务层异常2）

{
    "appId": "APP_00789396918",
    "code": 200,
    "data": "{\"providerCode\":\"S001639920829\",\"paySubType\":\"NATIVE\",\"mchOrderNo\":\"18b7a7b2343532543244334234d187\",\"subject\":\"不可思议的钢鞋子\",\"description\":\"实用的木制薯条\",\"subChannelCode\":\"AC001464808991\",\"feeRate\":\"{\\\"SINGLE_PERCENT\\\":2}\",\"orderAmount\":\"561.55\",\"payAmount\":\"561.55\",\"channelFeeAmount\":\"1.46\",\"failCode\":\"X\",\"failReason\":\"当前商户未认证，请通知商户在支付宝搜索“支付宝商家认证助手”小程序，完成认证后开通交\",\"state\":7,\"channelCode\":\"easypayold\",\"payOrderNo\":\"P202601121928452056309\",\"channelFeeRate\":\"[{\\\"rateType\\\":\\\"SINGLE_PERCENT\\\",\\\"RateBase\\\":0.26}]\",\"instOrderNo\":\"9975765766902444781568\",\"feeAmount\":\"11.23\",\"productCode\":\"Ali-PAY\",\"payDataType\":\"payUrl\"}",
    "msg": "请求成功",
    "sign": "WbKErzGRC7YeklwPtHY4B1lRZe9D/KcV6wzh68AMXnZiAqE2as/cJmwMCFhWIEJynWM4tjtkeC7BXvsrZ15WO1NT29g5UXIC4nA/fTPhgIZFZAyFFukYdvh5/Kl6qoDVwHRkiD6meJs6SPC20A/ELqIrxyoUa0KOqjnBEOQYN/nWvxk07nnICcMjHuGsogCs7AOxT2LZhNDfm6cvA5V+6/o3Ce2SvC1xzO55h76VZ59nciLbl8/y6WQTB5k++LTVmO+r2o0t5vIZ+ieugryNqAuqgVtp4v//+KZeOy4ro167KoBKo8IYYd5uHoGBBxq6QI+AUOVgWHuPVlXg56vhvw==",
    "signType": "RSA2",
    "timestamp": 1768217326155
}

3.1.9【抖音】H5交易指引

3.2.2 统一交易查询