googlepay
全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
POST
/cashier
注意
流程说明
请求参数对象说明
payerInfo
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| paymentMethod | Y | string | 期望使用googlepay支付，请传值为"googlepay" |
| authorizationMethod | Y | string | cvv （普通交易） |
| billingAddress | Y | Json String | 账单地址 |
| firstName | N | String(56) | 持卡人名（如果为空，则UseePay会用账单/收货地址姓名填充） |
| lastName | N | String(56) | 持卡人名（如果为空，则UseePay会用账单/收货地址姓名填充） |
| threeDS2RequestData | N | 3ds请求参数 |
billingAddress 账单地址信息
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Y | string | 收货邮箱 | |
| firstName | Y | string | 收货人名 |
| lastName | Y | string | 收货人姓 |
| phoneNo | N | string | 收货手机号 |
| street | Y | string | 收货街道地址 |
| houseNo | N | string | 收货街道地址和门牌号当street存在时可以不填 |
| postalCode | Y | string | 邮编，如果该国家或地区由邮编必须传，否则可以不传 |
| city | Y | string | 城市 |
| state | Y | string | 省/州/地区, 需满足 ISO 3166-2 |
| country | Y | string | 国家，ISO 两位大写英文国家代码, 需满足 ISO 3166-1 |
orderInfo 订单信息
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| subject | Y | string | 订单标题 |
| goodsInfo | Y | array | 商品信息, 请参考 goodsInfo |
| shippingAddress | Y | object | 收货地址, 请参考 shippingAddress |
goodsInfo 商品信息
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| id | Y | string | sku id |
| name | Y | string | 商品名 |
| body | Y | string | 商品描述 |
| quantity | Y | number | 商品数量 |
| price | Y | string | 商品价格,必须大于0，单位为对应货币的最小 货币单位参考货币单位一节 |
| url | N | string | 商品链接 |
| image | N | string | 商品图片 |
[
{
"id": "商品编号",
"name": "商品名称",
"body": "商品描述",
"category": "商品类目",
"categoryTree": "商品类目树，不同级别类目使用”|”分割",
"brand": "商品品牌",
"quantity": 1,
"price": 1234,
"url": "商品url",
"sku": "商品sku",
"image": "商品图片url"
}
]shippingAddress 收货地址
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Y | string | 收货邮箱 | |
| phoneNo | N | string | 收货手机号 |
| firstName | Y | string | 收货人名 |
| lastName | Y | string | 收货人姓 |
| street | Y | string | 收货街道地址 |
| houseNo | N | string | 收货街道地址和门牌号当street存在时可以不填 |
| postalCode | Y | string | 邮编，如果该国家或地区由邮编必须传，否则可以不传 |
| city | N | string | 城市 |
| state | Y | string | 省/州/地区, 需满足 ISO 3166-2 |
| country | Y | string | 国家，ISO 两位大写英文国家代码, 需满足 ISO 3166-1 |
{
"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
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| userId | N | string | max=128 用户id |
| ip | Y | string | max=128 IPv4或IPv6 |
| Y | string | max=128用户邮箱 | |
| phoneNo | N | string | max=32 用户手机号 |
请求参数
Header 参数
Body 参数application/x-www-form-urlencoded
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://pay-gateway1.uat.useepay.com/cashier' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'amount=100' \
--data-urlencode 'appId=www.pay.com' \
--data-urlencode 'autoRedirect=false' \
--data-urlencode 'country=JP' \
--data-urlencode 'currency=USD' \
--data-urlencode 'deviceInfo={"fingerPrintId":"设备指纹id","mac":"设备mac地址"}' \
--data-urlencode 'echoParam=echoParam' \
--data-urlencode 'merchantNo=500000000007362' \
--data-urlencode 'notifyUrl=http://gatewaytest.useepay.com/notifyV2u0' \
--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 'payerInfo={"authorizationMethod":"cvv","threeDS2RequestData":{"deviceChannel":"browser","acceptHeader":"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9","colorDepth":24,"javaEnabled":"false","language":"zh-HK","screenHeight":1080,"screenWidth":1920,"timeZoneOffset":-480,"userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/113.0.0.0 Safari/537.36","threeDSMethodCallbackUrl":"http://star-saas.mynatapp.cc:80/api/UseePayReturn?tradeNo=166614926624432064&type=1"},"billingAddress":{"houseNo":"El Gallo Giro(https://gallogiro.com/)","email":"hai1ley@useepay.com","phoneNo":"1235854433","firstName":"amber","lastName":"Yang","stlogreet":"7148 Pacific Blvd, Huntington Park, CA","postalCode":"90225","city":"Huntington Park","state":"CA","country":"MX","street":"street"}}' \
--data-urlencode 'redirectUrl=http://192.168.1.56:8005/redirectV2u0' \
--data-urlencode 'sign=bed4b8b0c5d8c865fc461d078e4d960e' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'terminalType=WEB' \
--data-urlencode 'transactionExpirationTime=1880' \
--data-urlencode 'transactionId=6b4f4765-ceb6-4b34-af47-2e02eb706c6a' \
--data-urlencode 'transactionType=pay' \
--data-urlencode 'userInfo={"userId":"victor1","ip":"103.25.65.178","email":"dynam1ic_3d@useepay.com"}' \
--data-urlencode 'version=1.0' \
--data-urlencode 'gatewaySource=SHOPIFY、SHOPLINE、SHOPYY、SHOPBASE、funpinpin等'响应示例响应示例
{
"amount": "1234",
"redirectUrl": "https://checkout1.uat.useepay.com/v2?accessToken=eAFlVVtvG0UU_ivR9AVQ7OzsJb48kTgNjZQEIyetqqYP493JepTdnWV2Nq5lIsFL20iJUgRFSBVS1ZciIVXACwgK_S-ojssTf4FzZnedbesoludcv3PmO2emRPEsjzTpTsmhUJneZTEnXXJT-FoqskwitpDdZkkIEp-pYG-S8ox07xCWphFP2YTcXSYh03zMJgOZKx9j7A-uX--v3QaXPONqTx7xZCs5lOA2NUF24SdxbQs-H5kP_ioTDPwRN0CORcaqpBjBuFDLdimlnuO0PNqmLdrpuJ0OmMVc-SOW6K0A7DyMV3xazqoNasVDkWmu9gGPMTk2ZVpWi5xAAVBHzBO9w_VIBlhegbMqdko0lA2BF0WjU1I07C2ZVAEkMLVOyVBEkUjCDZ75SqTY1S4J86ImJUog4_G4CembvoxRkyvFE38ClvuDDRCEEgAVAcmd6QERMQv5AekekNnj-7Nvvpo9-Xt--iBX0QFZPiCf59ACoSdgQOGYKuEXxtRuOq4xQdR1_0fn8-c_G40IavL5y-9mF78ZuQ-3G0o12VO87jn_5c_5kxeXT7_-7-XZ69_PZ4_O5n88nz38qZC__uvV_Nsf__nyhy_gf_bw_uz0VxNsKANEV8G_vLh486pIX6WpaYtQxi87ymsKc4ICh4olddTQkPnpmXEwLVnkMaeTu1VDS66_efFsdv748umDf599D6qKQ5-aS0Qi2ZbtWJ7tWZS2LIuCTXHBqKMWLZTUoa3VdrtD26DXgChbi2GsCKjdSoJMAlHGIk5OlonIeiz5LBf-UR8mqEsmMFPAwpFMuJmNDxzb-XDJa3sN13UcUPGYiQgMC9o2JzCQH8Ns4QCWzGFR1JPJoQgr9rGApcB4cLIQxlBqLeNbgB8kAw5E40s9GOglQIDcBxMcoJBvw1cOJAMzLNhXnBXUFYlAKx4PeRDwYDMKMTZKkmBPxLwnI0Pxa5ubrmvmOYx1D905qoGSnm23YX69NswmUDvWOzIQh5NSu9pyOo7jea7ntaBFgJNipwYjOe7JPNGBHOMSwIzRFUZYDHBzTCR70DxQX4OrsjfQKEakxbQXx9qGqAtKMhgR4oHJhDgsiEWyBmGgxev6_egozqGlSV_c43A1NlhCI2De-zKKsCTYIx5unkAo7mOpVUszqGgtTdeZuuFBJuzylajv10TrsEHgiNDQAo_vLpTKe71-v5UDXvBIRkG5qhbi4-Nakk0pC55UoT7BnRPA1qqlNrJ3wmzLEBd5FdWMDV7boqJbfJgJvShbM6XfIoq7hn9Y3CTZlRpaD0tAyKTYw2VozeM0Ag7h2nYdmLDyXF7bLh_fkLDag5LHfaTuldW-wgauHOMjYGYTAcgc59NutxG6VpNt6bOqzzBVO-VbMiiwW-QERra6xyLgSOs0666slC-f5plu1uaxkjdQsVK53rRzTFitGfMOvf9U4Su7K7fzUdIbcf-IdA9ZlPHl4u2BIit0WwFMbcXWKiYug2YGS3Eo71WAsMbyAY1l2o1ZKroIKeuurnJGWdtqHLLhsEEpDxps6FqNIeUdywoct80pOfkflOHNfA%3D%3D",
"resultCode": "received",
"sign": "9080da2b45be15a7d5535e4afd15be3c",
"errorCode": "0000",
"transactionId": "202305250117001",
"errorMsg": "Approved or completed successfully",
"token": "mop:mapi:redis:66ea1a80-fabb-11ed-ab40-b1e900d348e1",
"transactionType": "pay",
"reference": "1012305251317688918",
"echoParam": "echoParam",
"reserved": "reserved",
"signType": "MD5",
"currency": "USD",
"merchantNo": "500000000007362"
}修改于 2025-10-17 07:20:29