跳到主要内容

直连-虚拟产品

网关地址​

POST

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

测试账号​

商户号：10153

ApiKey: 9k8rx7j0fxa7deb250huvghfbbjnu23h

测试卡号​

卡号有效期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是否网站系统, 如：Shopyy/Shopline

请求支付返回参数​

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

返回示例​

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)

参数名称类型是否必填参数说明
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
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) ""
}

Demo​

import { md5 } from "js-md5";
import axios from "axios";

const KEY = "9k8rx7j0fxa7deb250huvghfbbjnu23h";
const MEMBER_ID = "10153";
let query = {
  pay_memberid: MEMBER_ID,
  pay_orderid: "O" + Date.now().valueOf(),
  pay_applydate: "2024-07-18 06:22:55",
  pay_bankcode: "901",
  pay_notifyurl: "https://www.google.com",
  pay_callbackurl: "https://www.google.com",
  pay_amount: "6",
};
let signData = [];
Object.keys(query)
  .sort()
  .forEach((key) => signData.push(`${key}=${query[key]}`));

signData.push(`key=${KEY}`);
Object.assign(query, {
  pay_md5sign: md5(signData.join("&")).toUpperCase(),
  pay_url: "https://www.google.com",
  pay_currency: "USD",
  pay_cardno: "4242424242424242",
  pay_cardmonth: "08",
  pay_cardyear: "2026",
  pay_cardcvv: "123",
  pay_productname: JSON.stringify([
    {
      productName: "Game Coin",
      price: "6.00",
      quantity: " 1",
    }
  ]),
  pay_firstname: "Rodrigo",
  pay_lastname: "lopez",
  pay_country_iso_code_2: "CL",
  pay_email_address: "[email protected]",
  pay_telephone: "+920508435",
  pay_ip: "186.156.221.158",
  pay_useragent:
    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/111.0.0.0 Safari/537.36 Edg/111.0.1661.43",
  pay_language: "zh",
  system: "shopyy",
});

axios
  .request({
    url: "https://sandbox.j-pay.net/pay_index",
    method: "post",
    headers: {
      "Content-Type": "application/x-www-form-urlencoded",
    },
    data: query,
  })
  .then(({ data }) => {
    console.log("success", data);
  })
  .catch((error) => {
    console.log("error", error);
  });