Alipay Direct 文档

全球收单-SandBox环境

POST

/api

时序图

Request 请求参数说明

PayerInfo Object

参数	必选	类型	说明
paymentMethod	Y	String	alipay
osType	Y	String	terminalType为WAP的时候必传IOS/ANDROID
terminalType	Y	String	WEB/WAP

UserInfo Object

参数	必选	类型	说明
userId	N	string	max=128 用户id
ip	Y	string	max=128 IPv4或IPv6
email	N	string	max=128用户邮箱
phoneNo	N	string	max=32 用户手机号

OrderInfo Object

参数	必选	类型	说明
subject	Y	String（128）	订单标题，可以是商品名称
goodsInfo	N	Array Json String (4096)	商品信息, 请参考 goodsInfo

goodsInfo

参数	必选	类型	说明
name	Y	String	商品名
body	Y	String	商品描述
quantity	Y	number	商品数量
price	Y	String	商品价格,必须大于0，单位为对应货币的最小货币单位参考货币单位一节
url	N	String	商品链接
image	N	String	商品图片

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/x-www-form-urlencoded

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

transactionType

string

交易类型: pay

必需

示例值:

pay

version

string

必需

目前固定为1.0(5)

示例值:

1.0

signType

string

必需

商户生成签名字符串所使用的签名算法类型，目前支持:RSA/MD5

示例值:

MD5

merchantNo

string

商户号

必需

示例值:

500000000007362

transactionId

string

商户订单号

必需

示例值:

202212070142347

transactionExpirationTime

string

可选

单位分钟，不能超过10分钟

示例值:

appId

string

网站域名

必需

示例值:

www.pay.com

amount

string

必需

支付金额，单位为对应币种的最小货币单位货币单位

示例值:

123

redirectUrl

string

跳转商户地址

可选

示例值:

https://gatewaytest.useepay.com/gateway-test/redirectV2u0

currency

string

必需

3位ISO大写字母货币代码货币单位

示例值:

USD

notifyUrl

string

异步通知

必需

示例值:

https://gatewaytest.useepay.com/gateway-test/notifyV2u0

echoParam

string

可选

回声参数，响应报文会原样返回

示例值:

echoParam

payerInfo

string

付款方信息

必需

示例值:

{ "paymentMethod": "alipay", "osType": "terminalType为WAP的时候必传IOS/ANDROID" , "terminalType": "WEB/WAP"}

orderInfo

string

订单信息

必需

示例值:

{"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"}}

userInfo

string

消费者信息

必需

示例值:

{ "userId": "victor007", "ip": "103.25.65.178", "email": "victor.yang@useepay.com", "phoneNo": "(323) 585-4433" }

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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", "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

string

必需

支付金额，单位为对应币种的最小货币单位(详见 ISO 4217)(12)

redirectUrl

string

必需

当resultCode=pending时存在

resultCode

string

业务结果码

必需

判断交易是否成功 received 表示收银台请求被成功接受，可以返回redirectUrl给消费者

sign

string

必需

errorCode

string

错误返回码

必需

用于展示给消费者具体的错误信息，可参考错误码页面

transactionId

string

必需

max=64 商户订单号，建议每次请求的 transactionId 唯一，有利于后续订单查询和对账。

errorMsg

string

错误返回信息

必需

用于展示给消费者具体的错误信息，可参考错误码页面

transactionType

string

必需

reference

string

必需

signType

string

签名类型

必需

currency

string

必需

max=3 位 ISO 大写字母货币代码(详见 ISO 4217) 目前仅支持JPY

merchantNo

string

必需

示例

成功示例异常示例

{
  "amount": "200",
  "redirectUrl": "https://open-sea-global.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040092tD2Y2sw7o9hJuk8Yef7v47tt&loadMode=2",
  "resultCode": "pending",
  "sign": "7e7ff13816c134645797fd23a4d5d190",
  "errorCode": "3200",
  "transactionId": "Al022305180025118",
  "errorMsg": "Transaction is pending",
  "transactionType": "pay",
  "reference": "1012305180025688429",
  "signType": "MD5",
  "currency": "CNY",
  "merchantNo": "500000000009545"
}

修改于 2023-10-14 02:00:14

Klarna Redirect

alipay_cn/alipay_hk direct 文档

Alipay Direct 文档

时序图#

Request 请求参数说明#

PayerInfo Object#

UserInfo Object#

OrderInfo Object#

goodsInfo#

请求参数

示例代码

返回响应

时序图

Request 请求参数说明

PayerInfo Object

UserInfo Object

OrderInfo Object

goodsInfo