boleto_Direct - 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)

必需

示例值:

500000000007362

transactionId

string

商户订单号(64)

必需

示例值:

202302081017053

transactionExpirationTime

string

可选

过期时间 (分钟)(6)

示例值:

appId

string

网站域名(128)

必需

示例值:

www.pay.com

amount

string

必需

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

示例值:

120

redirectUrl

string

可选

跳转商户地址(512)

示例值:

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

currency

string

必需

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

示例值:

USD

notifyUrl

string

异步通知(512)

必需

示例值:

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

echoParam

string

可选

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

示例值:

echoParam

payerInfo

string

必需

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

示例值:

{ "paymentMethod": "boleto", "authorizationMethod": "cvv", "paymentToken": "", "cardNo": "4693960111089859", "expirationMonth": "10", "expirationYear": "24", "email": "victor.yang@useepay.com", "country": "BR", "document": "84342411458", "cvv": "565", "firstName": "qiuhua", "lastName": "yang", "billingDescriptor": "", "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": 1080, "screenWidth": 1920, "timeZoneOffset": -480, "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 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/api' \
--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=500000000007362' \
--data-urlencode 'transactionId=202302081017053' \
--data-urlencode 'transactionExpirationTime=30' \
--data-urlencode 'appId=www.pay.com' \
--data-urlencode 'amount=120' \
--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": "boleto",
  "authorizationMethod": "cvv",
  "paymentToken": "",
  "cardNo": "4693960111089859",
  "expirationMonth": "10",
  "expirationYear": "24",
  "email": "victor.yang@useepay.com",
  "country": "BR",
  "document": "84342411458",
  "cvv": "565",
  "firstName": "qiuhua",
  "lastName": "yang",
  "billingDescriptor": "",
  "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": 1080,
    "screenWidth": 1920,
    "timeZoneOffset": -480,
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 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}

示例

amount=100&appId=www.pay.com&autoRedirect=true&country=&currency=EUR&deviceInfo=&echoParam=echoParam&gatewaySource=useepay&language=&merchantNo=500000000007381&notifyUrl=https://gatewaytest.useepay.com/gateway-test/notifyV2u0&orderInfo={"subject":"订单标题"}&payerInfo={"paymentMethod":"giropay","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"}}&redirectUrl=https://gatewaytest.useepay.com/gateway-test/redirectV2u0&reserved=reserved&sign=e719acf5ee23072f3af144e42451219d&signType=MD5&terminalType=WEB&transactionExpirationTime=30&transactionId=202203130722437&transactionType=pay&userInfo={"userId":"victor007","ip":"103.25.65.178","email":"victor.yang@useepay.com","phoneNo":"(323)+585-4433","createTime":"20200520131400"}&version=1.0