跳到主要内容

SDK - 直连实体支付

测试卡号​

卡号有效期cvv
424242424242424212 2027123测试成功
400000000000101812 2027123测试失败
414141414141414112 2027123测试跳转

请求参数​

参数名称类型是否必填参与签名参数说明
pay_memberidString是是平台分配商户号
pay_orderidString是是上送订单号唯一, 字符长度 20
pay_applydateString是是提交时间, 时间格式：2016-12-26 18:18:18
pay_bankcodeString是是银行编码, 参考后续说明：901
pay_notifyurlString是是服务端返回地址.（POST 返回数据）
pay_callbackurlString是是页面跳转返回地址（POST 返回数据）
pay_amountString是是商品金额
pay_md5signString是否请看 MD5 签名字段格式
pay_currencyString是否币种代码，大写字母 (USD)
pay_urlString是否网站URL, 需提交审核、带http(s)://
pay_cardnoString否否卡号
pay_cardmonthString否否2位月份 (02)
pay_cardyearString否否4位年份 (2023)
pay_cardcvvString否否cvv
+pay_productnameString是否商品信息，参数由下列一组数据，通过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"}]
「skuString是否商品编号 (唯一)
「productNameString是否产品名称
「productImageString是否产品图片URL
「attributesString是否产品属性
「priceString是否产品价格
「quantityString是否产品数量
pay_firstnameString是否账单名字
pay_lastnameString是否账单姓氏
pay_street_address1String是否账单地址1
pay_street_address2String是否账单地址2
pay_cityString是否账单城市
pay_postcodeString是否账单邮编
pay_stateString是否账单州/省
pay_country_iso_code_2String是否账单国家
pay_email_addressString是否账单邮箱
pay_telephoneString是否账单电话
shipping_firstnameString是否收件名字
shipping_lastnameString是否收件姓氏
shipping_street_address1String是否收件地址1
shipping_street_address2String是否收件地址2
shipping_cityString是否收件城市
shipping_stateString是否收件州/省
shipping_postcodeString是否收件邮编
shipping_country_iso_code_2String是否收件国家
shipping_telephoneString是否收件电话
pay_ipString是否用户IP地址
pay_useragentString是否用户浏览器信息
pay_languageString是否语言
systemString是否网站系统, 如：zencart/opencart/wrodpress/magento

请求支付返回参数​

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

示例​

$result = {"ststus":"0","msg":"success"}
$result = {"status":"1","url":"'.$json['url'].'"}
$result = {"status":"2","msg":"'.$json['msg'].'"}
$json = json_decode($result, true);
if ($json['status'] = '0') {
  跳转成功页面
 }elseif ($json['status'] = '1') {
  跳转3d支付地址
} elseif($json['status']= '2') {
  跳转失败页面
} else {
  echo $result;//直接输出
  exit;
}

3DS验证​

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

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

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

示例​

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

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

参数名称类型是否必填参数说明
memberidString是商户 ID
orderidString是商户订单号
amountString是提交的订单金额
true_amountString是买家实际付款的金额
currencyString是币种
transaction_idString是平台订单号
returncodeString是“00” 为成功
"2"：为失败
datetimeString是交易时间，格式：20220419000114
signString否请看验证签名字段格式
attachString

Demo​

require_once 'vendor/autoload.php';
    use Jpay\PaymentSDK\JpayPaymentSDK;
    $sdk = new JpayPaymentSDK(
        'your_merchant_id',
        'your_secret_key',
        'entity',     // entity
        'true'                     // true 或者 false, 默认 true(开发环境)
    );
//下面只是示例，真正需要传的参数看上面的参数要求来传
      $paymentData = [
        'pay_orderid' => 'your pay orderid',
        'pay_notifyurl' => 'https://your-domain.com/notify',
        'pay_callbackurl' => 'https://your-domain.com/callback',
        'pay_amount' => '100.00',
        'pay_currency' => 'USD',
        'pay_firstname' => 'John',
        'pay_lastname' => 'Doe',
        'pay_email_address' => '[email protected]',
        'pay_telephone' => '1234567890',
        'pay_country_iso_code_2' => 'US',
        'pay_productname' => 'Test Product'
    ];

    $result = $sdk->payment($paymentData);