USEEPAY
  1. Alipay
USEEPAY
  • 全球收单
    • 集成流程说明
    • 域名说明
    • 生产账户启用
    • UseePay出口IP说明
    • 签名指导
      • 签名
      • 验签
      • demo
    • 沙盒测试资源
      • 测试卡号
      • 信用卡测试案例
      • 退款测试案例
      • 本地化测试案例
      • ApplePay&& Google Pay测试用例
    • 跳转式收银台接口
      • 跳转收银台paymentMethod参数说明
      • 支付/预授权
    • 内嵌式收银台接口
      • 信用卡
        • 2.x 版本内嵌收银台
        • 1.x版本内嵌收银台
        • 内嵌收银台版本更新说明
        • 内嵌订阅收银台
      • 新版-支持信用卡+AP+GP
        • 内嵌收银台2.0.0版本说明
      • create token 创建JSSDK所需的token
    • 订单通用接口
      • 退款Refund
      • 查询Query
      • 预授权撤销(Void)
      • 预授权完成(Capture)
    • 本地化支付
      • 本地化汇总
      • 本地化接口
        • 便利店支付
          • konbini
            • konbini 收银台模式
            • konbini api模式
          • payeasy
            • payeasy api 模式
            • payeasy 收银台模式
        • 分期付款Pay Later
          • Klarna产品介绍
          • Klarna direct
          • Klarna Redirect
        • 电子钱包
          • Alipay
            • Alipay Direct 文档
              POST
            • alipay_cn/alipay_hk direct 文档
              POST
          • Wechat-HK
            • 微信退款
            • 扫码支付
              • 扫码支付
              • direct
                • 扫码支付 Server To Server模式
              • redirect
                • 扫码支付收银台模式(wechat_native)
            • Jsapi支付下单接口
              • 小程序支付
              • 微信公众号支付
              • Jsapi支付下单接口
            • H5支付
              • H5支付
          • Google Pay
            • GoogePay Test card
            • Google Pay 对接可能遇到的问题
            • redirect
              • 跳转式GooglePay收银台
            • api
              • Google Pay API对接
              • Googlepay API 支付
          • applepay
            • ApplePay 扩展
            • ApplePay API
              • ApplePay API接入流程
              • ApplePay API接入流程备份
              • ApplePay Merchant Identifier
              • ApplePay支付
              • ApplePay商户Session
            • applepay cashier
              • applepay 跳转收银台
          • applepay&googlepay内嵌
            • 1.0.0 内嵌方式对接 (建议使用“内嵌方式对接2.0.0”版本)
            • 内嵌方式对接2.0.0
        • 银行转账
          • pix
          • Giropay
            • Giropay_Redirect
            • Giropay_Direct
          • sofort
            • sofort_Redirect
            • sofort_Direct
          • bancontact
            • bancontact_Redirect
          • Ideal
            • Ideal_Redirect
            • Ideal_Direct
          • boleto
            • boleto_Direct
        • 本地化Card
        • Cash(Ticket)现金支付
          • oxxo
          • boleto
          • Cash Common
      • 支付方式(国家/地区)
        • 荷兰
        • 巴西
        • 墨西哥
        • 中国香港
        • 日本
        • 德国
        • 奥地利
        • 西班牙
        • 波兰
        • 意大利
        • 哥伦比亚
        • 比利时
        • 瑞士
    • 通用对象参数和规范说明
      • 参数对象说明(过期)
      • 业务结果码(ResultCode)
      • 错误码(ErrorCode)
      • 金额和货币单位
      • 国家信息参考
      • 对象模型
        • userInfo
        • shippingAddress
        • goodsInfo
        • billingAddress
        • deviceInfo
        • transactionInfo
    • 通知接口说明
      • 交易通知
        • 同步通知
        • 异步 webhook版本升级
        • webhook
      • 拒付
        • 拒付webhook
    • 物流接口
      • 物流信息上送
        • 物流信息上传2.1
        • 物流信息上传(已废弃)
      • 物流信息查询
        • 物流信息查询2.1
        • 物流信息查询(已废弃)
    • 拒付接口
      • 拒付流程说明
      • 拒付查询
    • SFTP
      • SFTP
    • 常见问题
      • 支付和预授权的区别
    • demo
    • 插件安装指导
      • magento插件支付安装
        • Wechat/Alipay/UseePay Payments
    • 订阅
      • 订阅文档
  • 产品说明
    • 收银台
    • 内嵌式收银台
    • Server To Server 直连
  • FAQ
    • 集成和认证
    • 常见问题解答
    • ueeshop配置常见错误
    • ApplePay常见问题
  1. Alipay

alipay_cn/alipay_hk direct 文档

全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
POST
/api

时序图#

Request 请求参数说明#

PayerInfo Object#

参数必选类型说明
paymentMethodYStringalipay_cn/alipay_hk
osTypeYStringterminalType为WAP的时候必传IOS/ANDROID
terminalTypeYStringWEB/WAP

UserInfo Object#

参数必选类型说明
userIdNstringmax=128 用户id
ipYstringmax=128 IPv4或IPv6
emailNstringmax=128用户邮箱
phoneNoNstringmax=32 用户手机号

OrderInfo Object#

参数必选类型说明
subjectYString(128)订单标题,可以是商品名称
goodsInfoNArray Json String (4096)商品信息, 请参考 goodsInfo
goodsInfo#
参数必选类型说明
nameYString商品名
bodyYString商品描述
quantityYnumber商品数量
priceYString商品价格,必须大于0,单位为对应货币的最小货币单位参考货币单位一节
urlNString商品链接
imageNString商品图片

paymentMethodOptions 支付方式#

paymentMethodOptions是一个对象,可以通过paymentMethod从中取值
{
    "alipay_cn": {
        "checkoutUrl": "https://oss-local.marmot-cloud.com/page/simulation-wallet/cn/index.html?url=alipayconnect%3A%2F%2Fplatformapi%2Falipayconnectcode%3Fcode%3D281666040092t2u16IPnh8YNEC7QF1Uv3THA%26pspName%3DALIPAY_CN&webUrl=https%3A%2F%2Fpsp.ac.alipay.com%2Fpage%2Fsimulation-wallet%2Facwallet%2Falipayconnectcode.html%3Fcode%3D281666040092t2u16IPnh8YNEC7QF1Uv3THA%26pspName%3DALIPAY_CN&loadMode=2",
        "schemeUrl": "alipayconnect://platformapi/alipayconnectcode.html?code=281666040092t2u16IPnh8YNEC7QF1Uv3THA&pspName=ALIPAY_CN&loadMode=2"
    }
}
参数必选类型说明
checkoutUrlYStringalipay收银台地址
schemeUrlCStringWAP返回app可以调用
appLinkUrlCStringWAP返回app可以调用
codeUrlCStringWEB 端返回 二维码图片地址
codeValueCStringWEB端返回二维码的值

请求参数

Header 参数

Body 参数application/x-www-form-urlencoded

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://pay-gateway1.uat.useepay.com/api' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'transactionType=pay' \
--data-urlencode 'version=1.0' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'merchantNo=500000000007362' \
--data-urlencode 'transactionId=202212070142347' \
--data-urlencode 'transactionExpirationTime=10' \
--data-urlencode 'appId=www.pay.com' \
--data-urlencode 'amount=123' \
--data-urlencode 'redirectUrl=https://gatewaytest.useepay.com/gateway-test/redirectV2u0' \
--data-urlencode 'currency=USD' \
--data-urlencode 'notifyUrl=https://gatewaytest.useepay.com/gateway-test/notifyV2u0' \
--data-urlencode 'echoParam=echoParam' \
--data-urlencode 'payerInfo={ "paymentMethod": "alipay_cn", "osType": "terminalType为WAP的时候必传IOS/ANDROID" , "terminalType": "WEB/WAP"}' \
--data-urlencode 'orderInfo={"subject":"order title","goodsInfo":[{"id":"商品编号","name":"商品名称","body":"商品描述","category":"商品类目","categoryTree":"商品类目树,不同级别类目使用”|”分割","brand":"商品品牌","quantity":1,"price":1234,"url":"商品url","sku":"商品sku","image":"商品图片url"}],"shippingAddress":{"email":"haile1y@useepay.com","phoneNo":"123123","firstName":"Victor","lastName":"Yang","street":"Heathcoat House, 20 Savile Row","postalCode":"W1S 3PR","city":"London","state":"LND","country":"GB"}}' \
--data-urlencode 'userInfo={  "userId": "victor007",  "ip": "103.25.65.178",  "email": "victor.yang@useepay.com",  "phoneNo": "(323) 585-4433" }'

返回响应

🟢200成功
application/json
Body

示例
{
    "amount": "100",
    "resultCode": "pending",
    "sign": "e7bde1f2385ca2b115649d1396f33f2d",
    "errorCode": "3200",
    "transactionId": "202404240600542",
    "errorMsg": "Payment in progress",
    "transactionType": "pay",
    "reference": "1012404241800712324",
    "echoParam": "echoParam",
    "signType": "MD5",
    "nextAction": "{\"alipay_cn\":{\"checkoutUrl\":\"https://oss-local.marmot-cloud.com/page/simulation-wallet/cn/index.html?url=alipayconnect%3A%2F%2Fplatformapi%2Falipayconnectcode%3Fcode%3D281666040092t2u16IPnh8YNEC7QF1Uv3THA%26pspName%3DALIPAY_CN&webUrl=https%3A%2F%2Fpsp.ac.alipay.com%2Fpage%2Fsimulation-wallet%2Facwallet%2Falipayconnectcode.html%3Fcode%3D281666040092t2u16IPnh8YNEC7QF1Uv3THA%26pspName%3DALIPAY_CN&loadMode=2\",\"schemeUrl\":\"alipayconnect://platformapi/alipayconnectcode.html?code=281666040092t2u16IPnh8YNEC7QF1Uv3THA&pspName=ALIPAY_CN&loadMode=2\"}}",
    "currency": "CNY",
    "merchantNo": "500000000008901"
}
修改于 2024-10-09 03:37:13
上一页
Alipay Direct 文档
下一页
微信退款
Built with