Payment

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 of a merchant.
verifySign *	String	The merchants should verify the signature to ensure the response is from the server and not modified by any others.
currency*	String	Currency supported by 2Pay is "USD".
amount *	Number	Amount of a transaction.
vendor*	String	Payment methods. Potential values："alipay", "wechatpay", "paypal", "venmo", "unionpay", "creditcard", "truemoney", "alipay_hk", "tng", "gcash", "dana", "kakaopay", "bkash", "easypaisa".
reference*	String	The reference number of a trasaction in the merchant services system.
terminal*	String	Potential values: "ONLINE", "WAP", "YIP"，"MWEB"(for Wechat H5 payment).
ipnUrl*	String	Asynchronous callback Url. The IPN Url should be secure and reliable.
callbackUrl*	String	Synchronously return a http url via a callback url. This callback url is used to recieve notifications and messages of an event. The callback url should follow the macro rules. For example, xxxcallback_url?trans_no={amount}&amount={amount}. 2Pay will automatically replace the values of parameters in curly brackets ("{ }").
description	String	Description of a transaction on a bill / invoice.
timeout	String	The interval for a transaction to be expired. (measured in minutes) Default value: 120
goodsInfo	String	The product information (stores in an array) written in JSON format. For example, [{"goods_name":"name1", "quantity":"quantity1"}, {"goods_name":"name2", "quantity":"quantity2"}] Do not support special characters.

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": ""
}

Response

Parameter	Type	Description
result	Object	Result Object
ret_msg	String	Return response message.
ret_code	String	Return response status code.

Result Object

Parameter	Type	Description
amount	String	The amount of a transaction. This parameter will be returned when the transaction currency is "USD".
currency	String	Transaction currency. Currency supported by 2Pay is: "USD".
transactionNo	String	The transaction ID of 2Pay system.
reference	String	The reference number of a trasaction in the merchant services system.
cashierUrl	String	The Url using by cashiers.
settleCurrency	String	Currency code from ISO 4217. Potential value: "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))