跳转到主要内容

​
支付流程图

支付流程

​
请求URL

  • https://gateway.pay247.io/gateway/payin/create

​
请求方式

  • POST

​
请求参数

参数名必选类型说明
mch_id是string商户号
mch_order_no是string商户自生成订单号
mch_user_id是string商户用户的唯一标识（如果想隐藏用户id明文，可以使用md5加密传递）
currency是string支持【CNY,JPY,PHP,THB等 ，更多参考商户后台】
amount是string99.11 单位元，支持到两位小数
pay_method否string支付方式，如果为空，自动选择可用的支付方式
pay_theme可选string1. link: 收银台模式（默认），2. custom: 自定义模式，会返回银行卡或者收款码信息，商户需自己封装
client_ip是string下单用户的IP地址（一定要是用户的真实IP）
notify_url是string异步通知地址
return_url否string同步跳转地址
payer_id可选string【依据相关渠道】付款人身份证号
payer_name可选string【依据相关渠道】付款人姓名
payer_phone可选string【依据相关渠道】付款人手机号
payer_account_no可选string【依据相关渠道】 付款人银行卡号
timestamp是stringunix秒级时间戳
version是string接口版本: v2.0
uuid是string请求ID: 550e8400-e29b-41d4-a716-446655440000
sign是string签名token

​
可选参数说明

币种支付方式必填
🇹🇭 THBBANKpayer_name, payer_account_no
🇯🇵 JPYBANKpayer_name, payer_address

​
请求参数示例

{
  "mch_id": "Q0P5T8DOGN10000",
  "mch_order_no": "TRADE-405189",
  "mch_user_id": "U405189",
  "currency": "CNY",
  "amount": "99.11",
  "pay_mehod": "GCASH",
  "pay_theme": "link",
  "notify_url": "https://x.com/notify",
  "return_url": "https://x.com/return",
  "timestamp": "1693233334134",
  "version": "v1.0",
  "client_ip": "8.8.8.8",
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "sign": "81930c5a04d1c58fd1efe33b06e2ffa7"
}
响应参数名(data)必选类型说明
mch_id是string商户号
mch_order_no是string商户订单号
order_no是string系统订单号
currency是stringCNY, THB, PHP
amount是string99.00 单位元，支持到两位小数
pay_method是string银行名
pay_theme是string账号
status是string订单状态
pay_url是string支付链接，获取后跳转
返回示例(默认收银台模式) 
{
	"code": 0,
	"message": "success",
	"uuid": "550e8400-e29b-41d4-a716-446655440000",
	"timestamp": "1693233334134",
	"data": {
		"mch_id": "MCH12345678",
		"mch_order_no": "23082822325936693122",
		"order_no": "MO202308282232593669984082",
		"currency": "USD",
		"amount": "59.12",
		"pay_method": "BANK",
		"pay_theme": "link",
		"status": "PENDING",
		"pay_url": "https://pay.xxx.com/link/DyDpCjDfkr"
	}
}
返回示例(自定义收银台模式) 当前支持JPY 
{
	"code": 0,
	"message": "success",
	"uuid": "550e8400-e29b-41d4-a716-446655440000",
	"timestamp": "1693233334134",
	"data": {
		"mch_id": "MCH12345678",
		"mch_order_no": "23082822325936693122",
		"order_no": "MO202308282232593669984082",
		"currency": "USD",
		"amount": "59.12",
		"pay_method": "BANK",
		"pay_theme": "custom",
		"status": "PENDING",
		"pay_params": {
			"payee_name": "日本測試卡",
			"payee_account_no": "123",
			"payee_bank_name": "三菱UFJ銀行",
			"payee_branch_name": "日本測試卡",
			"qr": ""
		}
	}
}