payeasy api 模式

时序图

请求参数

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

商户号(16)

必需

示例值:

500000000007362

transactionId

string

商户订单号(64)

必需

示例值:

202212070142347

transactionExpirationTime

string

可选

过期时间 (分钟)(6)

示例值:

1880

appId

string

网站域名(128)

必需

示例值:

www.pay.com

amount

string

必需

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

示例值:

123

redirectUrl

string

可选

跳转商户地址(512)

示例值:

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

currency

string

必需

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

示例值:

JPY

notifyUrl

string

异步通知(512)

必需

示例值:

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

echoParam

string

可选

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

示例值:

echoParam

payerInfo

string

必需

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

示例值:

{ "paymentMethod": "payeasy", "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/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=1880' \
--data-urlencode 'appId=www.pay.com' \
--data-urlencode 'amount=123' \
--data-urlencode 'redirectUrl=https://gatewaytest.useepay.com/gateway-test/redirectV2u0' \
--data-urlencode 'currency=JPY' \
--data-urlencode 'notifyUrl=https://gatewaytest.useepay.com/gateway-test/notifyV2u0' \
--data-urlencode 'echoParam=echoParam' \
--data-urlencode 'payerInfo={
    "paymentMethod": "payeasy",
    "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"}'

payeasy api 模式

时序图#

请求参数

示例代码

返回响应

时序图