konbini 收银台模式

全球收单-SandBox环境

https://pay-gateway1.uat.useepay.com

POST

/cashier

功能说明

时序图

请求对象参数说明

PayerInfo 请求参数说明

参数	必选	类型	说明
paymentMethod	Y	String	目前固定为 konbini
billingAddress	Y	Json String	账单信息

billingAddress Object

参数	必选	类型	说明
firstName	Y	string	收货人名
lastName	Y	string	收货人姓
email	Y	string	收货邮箱
phoneNo	Y	string	收货手机号
street	N	string	收货街道地址
houseNo	N	string	收货街道地址和门牌号当street存在时可以不填
postalCode	N	string	邮编，如果该国家或地区由邮编必须传，否则可以不传
city	N	string	城市
state	N	string	省/州/地区, 需满足 ISO 3166-2
country	N	string	国家，ISO 两位大写英文国家代码, 需满足 ISO 3166-1

orderInfo 订单信息

参数	必选	类型	说明
subject	Y	string	订单标题
goodsInfo	N	array	商品信息, 请参考 goodsInfo
shippingAddress	N	object	收货地址, 请参考 shippingAddress

请求参数

Header 参数

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

示例代码

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 'amount=100' \
--data-urlencode 'appId=www.pay.com' \
--data-urlencode 'autoRedirect=false' \
--data-urlencode 'country=JP' \
--data-urlencode 'currency=JPY' \
--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={"paymentMethod":"konbini","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=9ee208a2dcdd4bbc9ba0a99be4b6b0d8' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'terminalType=WEB' \
--data-urlencode 'transactionExpirationTime=1880' \
--data-urlencode 'transactionId=490f9dc6-59c9-49b5-8c88-2a948f1b4d3b' \
--data-urlencode 'transactionType=pay' \
--data-urlencode 'userInfo={"userId":"victor1","ip":"103.25.65.178","email":"useepay@useepay.com"}' \
--data-urlencode 'version=1.0'

返回响应

🟢200成功

application/json

Body

示例

成功示例异常示例

{
    "amount": "100",
    "redirectUrl": "https://checkout1.uat.useepay.com/v2?accessToken=eAFlVVtvG0UU_ivR9NV29uqs94nEbWhRkholpaqaCs3ujNcj784ss7NxrRAJXkojpUoRl5cKibciISHgBQSF_hdU17zxFzhn1xsvIVGszLl-55zvHJ8SzYsyNSQ8JWOhC3NAM05CQrOIa9IhKb0SPaAyAUlO51zfkWOFLrEqpdFzcHhvVOsyLs0-NxPFQDhVMhJSkLMOSajhMzo_VKWOMcG9w1u3RtsPrjsVJHwIYalmR_Oc1y8D_7WDPeoQWaNUMhWSfxhRORUA7gw0SrM1vEikYJDc5EWsRW6UhjBJCTkhgRZghyBns1kPiurFKkNNqTWXcV0SwkuUYkVdL3l4ekxERhN-TMJjsvjqyeKLTxcv_lyef1bq9Jh0jslHJZVGmDkY2PDMtYhrY9txvcoCobfdnz9bvvyx0gjWki9ffb24_KWSx9C6ROn5keZtz-VPvy9f_PD228__eXXx5tdni-cXy99eLp5-X8vf_PF6-eV3f33yzcfwt3j6ZHH-cxUsUgzBNejfXl7-_bpO36RpaetQlV8xLVuK6gX1RZrKNmrox_L8onKoOnKVp3qdPWr6uWJZNawN6FfKQZNxHU-gfXerEeJovIE1HrC43_UH8aDrDSK_G8RB0HXowAvGduQxNwLHeuboYFvQZ8t3Asfx_H4wsN0A9AZQFtsZkBwMrEaABANJQSE5EFQUQyrfL0U8HVGc_hzYB2yfKMkPgOsEAvuB73muC2KeUZGCcEKFnfL5O2XB-ZpDNE2HSo5F0qwJZTQ3sE8hsTzwjpQxKrsPsEFyyIFyfGMIlN-AzLg_YIKNSPgefJRAN0yPQs1pTWJYKrTisKWMcbabJhgbJZIdiYwPVVqR_cburudVJSeZGaI7RzWQ03egSZ7tB5ZlAckzs6-YGM9X2v6WO3Bd3_d8fwtaAzht7NDhRM2GuPJMzeQqY7rGyCUggM7II2gaqG_Y9pZzE2FliLRet_pZT7rav7ZgxYtKhHhgRyEOZZmQ2xAGWrxj_h8dxSW0VI7EYw5jccASGgGbP1JpiiXBIfE7cOqY0DzGUpuWFlDRdp7vUH3bh0zY5bVoFLdEO3BL4InQ0AKf109L473Tnm_jgAOeqJStTteV-OSklWRXqZonTah38fowuF-t1JXsWpg9lSBJm6jVCuHYriq6z6NCmKuyDdXmP0TxtvEXi5vLA2Wg9XAPhJJXtxxDG57lKXAI5-a56_dqbAd8dlsVhrMVj0dI3bXVPY0N3DxxUIYriQBUiWvpBEEVX8_3VEybPsNW7a9uwmGN3SJnsKrNHOuAE2PycHPTHjg9ux_07J7fD4HV_mZj9oFTYvDmvFSk84H2q58tt4-I8DvnQO2VEzmc8HhKwjFNC94hNM9TDgU1SO4w2NCGmU1M_PLoFXALI_W4tzoGWKWawk6EJFN5mNFchAipCH03Gm9Zfas7Zv1-17Y569KIR11m-dyKqEcH1CVn_wKzjJ55",
    "resultCode": "received",
    "sign": "362e40f06091b1c22914d86c1c050911",
    "errorCode": "0000",
    "transactionId": "490f9dc6-59c9-49b5-8c88-2a948f1b4d3b",
    "errorMsg": "Approved or completed successfully",
    "token": "mop:mapi:redis:53bf7060-fd66-11ed-abeb-d05e0ba4a9a3",
    "transactionType": "pay",
    "reference": "1012305282245689138",
    "echoParam": "echoParam",
    "signType": "MD5",
    "currency": "JPY",
    "merchantNo": "500000000007362"
}

修改于 2023-10-14 01:59:32

本地化汇总

konbini api模式

konbini 收银台模式

功能说明#

时序图#

请求对象参数说明#

PayerInfo 请求参数说明#

billingAddress Object#

orderInfo 订单信息#