在线付款

SecurePay

POST https://api.2pay.co/online/v1/secure-pay

This API provides a fast and secure way for order payments

Request Body

Name	Type	Description
merchantNo*	String	商户ID
verifySign *	String	参数签名
currency*	String	交易货币 支持"USD"
amount *	Number	交易金额
vendor*	String	支付渠道 可能的数值："alipay", "wechatpay", "paypal", "venmo", "unionpay", "creditcard", "truemoney", "alipay_hk", "tng", "gcash", "dana", "kakaopay", "bkash", "easypaisa"
reference*	String	商家系统中交易的发票编号
terminal*	String	交易终端类型，可能的值: "ONLINE", "WAP", "ANDROID", "IOS"
ipnUrl*	String	异步回调地址，IPN网址必须是安全可靠的
callbackUrl*	String	同步回调HTTP地址，用于接收事件的通知消息。 回调网址需遵循宏替换规则，例如 xxxcallback_url?trans_no={amount}&amount={amount}，然后2Pay将自动替换有关参数列表{}里的值
description	String	显示在发票上面的交易说明
timeout	String	超时(以分钟为单位)。 默认值为120。
goodsInfo	String	客户从商家购买的商品数组的JSON编码字符串。 不支持特殊字符。 例如: [{"goods_name":"name1", "quantity":"quantity1"}, {"goods_name":"name2", "quantity":"quantity2"}]

200: OK

{
    "ret_code": "000100",
    "ret_msg": "prepay success",
    "result": {
        "amount": "1",
        "currency": "USD",
        "transactionNo": "558901a15-1c3f-427a-b838-83049b4efc47",
        "reference": "b6984c78-w8201-kqcak81jk",
        "cashierUrl": "https://api.2pay.co/app/url",
        "settleCurrency": "USD"
    }
}

400: Bad Request

{
    "ret_code": "000000",
    "ret_msg": ""
}

响应

参数	类型	描述
ret_msg	String	响应返回消息
ret_code	String	响应返回码
result	Object	结果对象

结果对象

Parameter	类型	描述
amount	String	交易金额。 当您使用"USD"作为付款货币时，它将返回
currency	String	交易货币："USD"
transactionNo	String	2Pay系统中的交易ID
reference	String	商家系统中交易的发票编号
cashierUrl	String	收银员页面的URL
settleCurrency	String	标识结算货币的三位字符货币代码。 可能的值为："USD"

cURL

curl --location --request POST 'https://api.2pay.co/online/v1/secure-pay' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchantNo": "M165937487",
    "vendor": "alipay",
    "reference": "b6984c78-8201-kqcak81jk",
    "amount": "1",
    "currency": "USD",
    "description": "your description",
    "terminal": "IOS",
    "callbackUrl": "https://{paidUrl}",
    "ipnUrl": "https://alipay.com/notify",
    "goodsInfo": "[{'\''goods_name'\'':'\''Plan'\'','\''quantity'\'':'\''1'\''}]",
    "timeout": "120",
    "verifySign": "{{verifySign}}"
}'

NodeJs

import request from 'request'
import CryptoJS from 'crypto-js'
const token = 'yjmsy9vwjkajsnwqqt4psc2o8y3rr5q'
const baseUrl = 'https://api.2pay.co'
const params = {
  merchantNo: 'M16593129121867',
  vendor: 'alipay',
  reference: '2991223db-4cdc-ba0f-7e15bfc9beb2',
  amount: '1.0000',
  currency: 'USD',
  description: 'Contact mail:',
  terminal: 'ONLINE',
  callbackUrl: 'https://pay.domain.com/paid.html',
  ipnUrl: 'https://pay.domain.com/2pay/notify',
  goodsInfo: '',
  timeout: '120'
}


function buildAndSignParams(params) {
  let sortArray = [];
  Object.keys(params).sort().forEach(k => {
      if (k == 'verifySign') {
          return
      }
    if(params[k] || params[k] === false) {
      sortArray.push(`${k}=${params[k]}`)
    }
  });
  sortArray.push(CryptoJS.MD5(token).toString());
  console.log('MD5 Token', CryptoJS.MD5(token).toString())
  const tempStr = sortArray.join('&');
  console.log('temStr:', tempStr)
  const verifySign = CryptoJS.MD5(tempStr).toString();
  console.log('verifySign', verifySign)
  return {
    ...params,
    verifySign
  }

}

const json = await request.post({
  url: BaseUrl + 'online/v1/secure-pay',
  form: buildAndSignParams(params)
});

PHP

<?php
    function securepay()
    {
        $url = 'https://api.2pay.co/online/v1/secure-pay';
        $token = '5cbfb079f15b150122261c8537086d77a';
        $params = [
              merchantNo => 'M16593129121867',
              vendor => 'alipay',
              reference => '2991223db-4cdc-ba0f-7e15bfc9beb2',
              amount => '1.0000',
              currency => 'USD',
              description => 'Contact mail:',
              terminal => 'ONLINE',
              callbackUrl => 'https://pay.domain.com/paid.html',
              ipnUrl => 'https://pay.domain.com/2pay/notify',
              goodsInfo => '',
              timeout => '120'
        ];
        ksort($params, SORT_STRING);
        $str = '';
        foreach ($params as $k => $v) {
            $str .= $k . '=' . $v . '&';
        }
        $params['verifySign'] = md5($str . md5($token));
        echo 'verifySign:', $params['verifySign'];
        echo "\n";
        $ch = curl_init($url);
        curl_setopt_array($ch, array(
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HEADER => false,
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => http_build_query($params),
        ));
        $result = curl_exec($ch);
        curl_exec($ch);
        echo $result;
        echo "\n";
        return json_decode($result, true);
    }
    securepay();
?>

Go

package main

import (
	"fmt"
	pay "github.com/2pay-co/golang-sdk"
	"github.com/gogf/gf/v2/os/gtime"
)

func main() {

	t := pay.New("MerchantNo", "Token")
	param := pay.SecurePay{
		Currency:    "USD",
		Amount:      "10",
		Vendor:      "alipay",
		Reference:   gtime.Datetime(),
		Terminal:    "ONLINE",
		IpnURL:      "https://google.com",
		CallbackURL: "https://google.com",
		Note:        "test order",
		Description: "test order",
		Timeout:     "120",
		GoodsInfo: []pay.GoodsInfo{
			{
				"test goods 1", "1",
			},
			{
				"test goods 2", "1",
			},
		},
	}

	resp, err := t.SecurePay(&param)
	fmt.Println(resp, err)
}

Java

TwoPayConfig config = new TwoPayConfig();
config.setEnv(EnviromentEnums.SANDBOX.getValue())
        .setMerchantNo("M1659370481867")
        .setToken("yjmsy9v5o2kam2sjsct4psc2o8y3rr5q");
TwoPayClient client = new TwoPayV100Client(InitTwoPayConfig.initMerchantConfig()); 		

TwoPayClient client = new TwoPayV100Client(InitTwoPayConfig.initMerchantConfig());
		
		JSONArray goods = new JSONArray();
		JSONObject item = new JSONObject();
		item.put("goods_name","name1");
		item.put("quantity", "1");
		goods.add(item);
		OnlineSecurepayRequest request = new OnlineSecurepayRequest();
		request.setAmount("0.01")
				.setCurrency("USD")
				.setVendor("alipay")
				.setTerminal("WAP")
				.setReference(System.nanoTime()+"")
				.setIpnUrl("http://xxxxxx/ttest/test")
				.setCallbackUrl("http://xxxxx/ttest/test")
				.setDescription("testDescription")
				.setGoodsInfo(goods.toString());
		OnlineSecurepayResponse response = client.execute(request);
		System.out.println(JSONObject.fromObject(response));

		RefundRequest rfd = new RefundRequest();
		rfd.setamount("1000000");
		rfd.setReference("6ce3653f-5365-4bcd-b596-e9007b683bec");
		RefundResponse rfs = client.execute(rfd);
		System.out.println(JSONObject.fromObject(rfs))