直连-订阅

网关地址

POST

https://sandbox.j-pay.net/pay_index

测试账号

Merchant ID：10010

ApiKey: 7e4nicn14nhyup146dfbi8hpnpus9juz

请求参数

参数名称	类型	是否必填	参与签名	参数说明
pay_memberid	String	是	是	平台分配商户号
pay_orderid	String	是	是	上送订单号唯一, 字符长度 20
pay_applydate	String	是	是	提交时间, 时间格式：2016-12-26 18:18:18
pay_bankcode	String	是	是	银行编码, 参考后续说明：901
pay_notifyurl	String	是	是	服务端返回地址.（POST 返回数据）
pay_callbackurl	String	是	是	页面跳转返回地址（POST 返回数据）
pay_amount	String	是	是	商品金额
pay_md5sign	String	是	否	请看 MD5 签名字段格式
pay_currency	String	是	否	币种代码，大写字母 (USD)
pay_url	String	是	否	网站URL, 需提交审核、带http(s)://
pay_cardno	String	否	否	卡号
pay_cardmonth	String	否	否	2位月份 (02)
pay_cardyear	String	否	否	4位年份 (2023)
pay_cardcvv	String	否	否	cvv
+pay_productname	String	否	否	商品信息，参数由下列一组数据，通过JSON格式组成，注意参数名大小写敏感。本字段以JSON数组字符串来填值。示例：[{"sku":"123456789","productName":"MacBook Pro","productImage":"产品图片地址","attributes":"Size:US8 Color:blue","price":"11000.00","quantity":"1"},{"sku":"9876543231","productName":"IPhone 12","productImage":"产品图片地址","attributes":"Size:US8 Color:blue","price":"11000.00","quantity":"1"}]
「sku	String	否	否	商品编号 (唯一)
「productName	String	是	否	产品名称
「productImage	String	否	否	产品图片URL
「attributes	String	否	否	产品属性
「price	String	是	否	产品价格
「quantity	String	是	否	产品数量
pay_firstname	String	是	否	账单名字
pay_lastname	String	是	否	账单姓氏
pay_street_address1	String	否	否	账单地址1
pay_street_address2	String	否	否	账单地址2
pay_city	String	否	否	账单城市
pay_postcode	String	否	否	账单邮编
pay_state	String	否	否	账单州/省
pay_country_iso_code_2	String	是	否	账单国家
pay_email_address	String	是	否	账单邮箱
pay_telephone	String	是	否	账单电话
pay_type	String	N	N	支付类型 (Subscription)
+subscription_plan	String	N	N	分期计划JSON数组字符串格式
「id	String	Y	N	计划UUID
「name	String	Y	N	计划名称
「plan_type	String	Y	N	计划类型(weekly, monthly, quarterly, yearly)
「first_period_amount	String	N	N	第一期金额, 没传则取订单金额
「description	String	Y	N	计划描述
「attempts	String	Y	N	当因资金不足而无法完成付款时,尝试付款的次数
「interval_time	Int	N	N	尝试重试次数间隔时间，单位：秒。默认3600秒
「total_count	Int	N	N	应向客户收费的计费周期数。例如，如果客户购买的是按月计费的 1 年期订阅，则此值应为12.默认一年除以周期
pay_ip	String	是	否	用户IP地址
pay_useragent	String	是	否	用户浏览器信息
pay_language	String	是	否	语言
system	String	是	否	网站系统, 如：Shopyy/Shopline

请求支付返回参数

参数名称	类型	参数说明
status	Int	status = 0：SUCCESS status = 1：3d支付跳转 status = 2：failed
msg	String	下单成功 or 下单失败
url	String	3d支付跳转地址

返回示例

Transaction successful : {
    "status": 0,
    "msg": "transaction success"
}
Transaction failed : {
    "status": 2,
    "msg": "transaction failed"
}
Redirect/3ds payment successful : {
    "status": 1,
    "url": "redirectUrl"
}

3DS验证

跳转支付和直接信用卡支付需要3DS验证

同步返回：(application/x-www-form-urlencoded)

参数名称	类型	是否必填	参数说明
paymentStatus	String	是	Succeeded: 成功 Fail:失败 Processing:处理中
orderID	String	是	订单号

示例

同步返回:

https://www.xxxx.com/callback.html?paymentStatus=succeeded&orderID=1001

异步返回:(application/x-www-form-urlencoded)

参数名称	类型	是否必填	参数说明
memberid	String	是	商户 ID
orderid	String	是	商户订单号
amount	String	是	提交的订单金额
true_amount	String	是	买家实际付款的金额
currency	String	是	币种
transaction_id	String	是	平台订单号
returncode	String	是	“00” 为成功 "2"：为失败
enabled	Int	否	0: 订阅已关闭
datetime	String	是	交易时间，格式：20220419000114
payment_transaction_id	String	是	订阅支付主订单号
payment_period_count	String	是	订阅周期数
sign	String	否	请看验证签名字段格式
attach	String

Array{
    ["memberid"]=>
    string(5) "10012"
    ["orderid"]=>
    string(7) "7758292"
    ["transaction_id"]=>
    string(20) "20230117104641499957"
    ["amount"]=>
    string(5) "85.95"
    ["true_amount"]=>
    string(5) "85.95"
    ["currency"]=>
    string(5) "USD"
    ["datetime"]=>
    string(14) "20230117111809"
    ["returncode"]=>
    string(2) "00"
    ["sign"]=>
    string(32) "48CF5D99A2ADE25DCEF73BC1B1136B9E"
    ["attach"]=>
    string(0) ""
}