Ideal_Redirect - USEEPAY

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/x-www-form-urlencoded

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

transactionType

string

必需

交易类型 : pay

示例值:

pay

autoRedirect

string

可选

false: 不跳转默认true

示例值:

true

version

string

必需

目前固定为 1.0 (5)

示例值:

1.0

signType

string

必需

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

示例值:

MD5

merchantNo

string

商户号(16)

必需

示例值:

500000000009133

transactionId

string

商户订单号(64)

必需

示例值:

202302081017053

transactionExpirationTime

string

可选

过期时间 (分钟)(6)

示例值:

appId

string

网站域名(128)

必需

示例值:

www.pay.com

amount

string

必需

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

示例值:

1000

redirectUrl

string

可选

跳转商户地址(512)

示例值:

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

currency

string

必需

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

示例值:

EUR

notifyUrl

string

异步通知(512)

必需

示例值:

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

echoParam

string

可选

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

示例值:

echoParam

payerInfo

string

必需

Json格式的String 付款方信息, 请下方

示例值:

{ "paymentMethod": "credit_card", "authorizationMethod": "threeds2.0", "billingDescriptor": "", "mpiData": { "threeDSVersion": "", "cavv": "", "dsTransId": "", "eci": "", "xid": "" }, "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-CN", "screenHeight": 1000, "screenWidth": 1600, "timeZoneOffset": -480, "userAgent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.198 Safari/537.36" }, "billingAddress": { "houseNo": "El Gallo Giro(https://gallogiro.com/)", "email": "victor.yang@useepay.com", "phoneNo": "(323) 585-4433", "firstName": "Victor", "lastName": "Yang", "street": "7148 Pacific Blvd, Huntington Park, CA 90255", "postalCode": "90225", "city": "Huntington Park", "state": "CA", "country": "US" }}

orderInfo

string

可选

json string, 订单信息, 请参考下方

示例值:

{ "subject": "订单标题", "goodsInfo": [ { "id": "商品编号", "name": "商品名称", "body": "商品描述", "category": "商品类目", "categoryTree": "商品类目树，不同级别类目使用”|”分割", "brand": "商品品牌", "quantity": 1, "price": 1234, "url": "商品url", "sku": "商品sku", "image": "商品图片url" } ], "deliveryMethod": "logistics", "deliveryTime": "", "shippingAddress": { "email": "victor.yang@useepay.com", "phoneNo": "+44 20 7734 9638", "firstName": "Victor", "lastName": "Yang", "street": "Heathcoat House, 20 Savile Row", "postalCode": "W1S 3PR", "city": "London", "state": "LND", "country": "GB" }}

userInfo

string

必需

json string, 消费者信息,请参考消费者信息

示例值:

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://pay-gateway1.uat.useepay.com/cashier' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'transactionType=pay' \
--data-urlencode 'autoRedirect=true' \
--data-urlencode 'version=1.0' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'merchantNo=500000000009133' \
--data-urlencode 'transactionId=202302081017053' \
--data-urlencode 'transactionExpirationTime=6' \
--data-urlencode 'appId=www.pay.com' \
--data-urlencode 'amount=1000' \
--data-urlencode 'redirectUrl=https://gatewaytest.useepay.com/gateway-test/redirectV2u0' \
--data-urlencode 'currency=EUR' \
--data-urlencode 'notifyUrl=https://gatewaytest.useepay.com/gateway-test/notifyV2u0' \
--data-urlencode 'echoParam=echoParam' \
--data-urlencode 'payerInfo={  "paymentMethod": "credit_card",  "authorizationMethod": "threeds2.0",  "billingDescriptor": "",  "mpiData": {    "threeDSVersion": "",    "cavv": "",    "dsTransId": "",    "eci": "",    "xid": ""  },  "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-CN",    "screenHeight": 1000,    "screenWidth": 1600,    "timeZoneOffset": -480,    "userAgent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.198 Safari/537.36"  },  "billingAddress": {    "houseNo": "El Gallo Giro(https://gallogiro.com/)",    "email": "victor.yang@useepay.com",    "phoneNo": "(323) 585-4433",    "firstName": "Victor",    "lastName": "Yang",    "street": "7148 Pacific Blvd, Huntington Park, CA 90255",    "postalCode": "90225",    "city": "Huntington Park",    "state": "CA",    "country": "US"  }}' \
--data-urlencode 'orderInfo={  "subject": "订单标题",  "goodsInfo": [    {      "id": "商品编号",      "name": "商品名称",      "body": "商品描述",      "category": "商品类目",      "categoryTree": "商品类目树，不同级别类目使用”|”分割",      "brand": "商品品牌",      "quantity": 1,      "price": 1234,      "url": "商品url",      "sku": "商品sku",      "image": "商品图片url"    }  ],  "deliveryMethod": "logistics",  "deliveryTime": "",  "shippingAddress": {    "email": "victor.yang@useepay.com",    "phoneNo": "+44 20 7734 9638",    "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",  "createTime": "20200520131400"}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

RequestResponse

amount=100&appId=www.pay.com&autoRedirect=false&country=&currency=EUR&deviceInfo=&echoParam=echoParam&gatewaySource=useepay&language=&merchantNo=500000000007381&notifyUrl=https://gatewaytest.useepay.com/gateway-test/notifyV2u0&orderInfo={"subject":"订单标题"}&payerInfo={"paymentMethod":"ideal","billingAddress":{"houseNo":"El+Gallo+Giro","email":"victor.yang@useepay.com","phoneNo":"3235854433","firstName":"Victor","lastName":"Yang","street":"7148+Pacific+Blvd,+Huntington+Park,+CA","postalCode":"000000","city":"Huntington+Park","state":"CA","country":"US"}}&redirectUrl=https://gatewaytest.useepay.com/gateway-test/redirectV2u0&reserved=reserved&sign=8711fc280d24e5d6ab980573e77bcc90&signType=MD5&terminalType=WEB&transactionExpirationTime=30&transactionId=202203130736240&transactionType=pay&userInfo={"userId":"victor007","ip":"103.25.65.178","email":"victor.yang@useepay.com","phoneNo":"(323)+585-4433","createTime":"20200520131400"}&version=1.0