alipay前置工作

alipay,alipay_cn,alipay_hk在实际使用前请在MC后台→合作伙伴→alipay-onboarding处进行注册申请，注册成功并在此绑定您需要支付的网站后，方可使用，否则会向你提示"0349 Function/service not enabled Please contact the merchant."
操作指引

时序图

Request 请求参数说明

PayerInfo Object

参数	必选	类型	说明
paymentMethod	Y	String	alipay_cn/alipay_hk
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	商品图片

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

参数	必选	类型	说明
checkoutUrl	Y	String	alipay收银台地址
schemeUrl	C	String	WAP返回app可以调用
appLinkUrl	C	String	WAP返回app可以调用
codeUrl	C	String	WEB 端返回二维码图片地址
codeValue	C	String	WEB端返回二维码的值

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

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

alipay_cn/alipay_hk

时序图#

Request 请求参数说明#

PayerInfo Object#

UserInfo Object#

OrderInfo Object#

goodsInfo#

paymentMethodOptions 支付方式#

请求参数