Collection Link V2 – Tạo đơn có dữ liệu HĐĐT

<?php

$endpoint = 'https://payment.pay2s.vn/v1/gateway/api/create';
$accessKey = getenv('PAY2S_ACCESS_KEY');
$secretKey = getenv('PAY2S_SECRET_KEY');
$partnerCode = getenv('PAY2S_PARTNER_CODE');

$requestId = (string) round(microtime(true) * 1000);
$orderId = 'ORDER-' . $requestId;
$amount = '110000';
$orderInfo = 'TT' . $requestId;
$requestType = 'pay2s';
$redirectUrl = 'https://merchant.example/return';
$ipnUrl = 'https://merchant.example/pay2s/ipn';
$bankAccounts = [['account_number' => '99999999', 'bank_id' => 'ACB']];

$metadata = [
    'invoiceType' => 'vat',
    'customerInfo' => [
        'buyerContactName' => 'NGUYỄN VĂN A',
        'buyerCompanyName' => 'CÔNG TY TNHH ABC',
        'taxCode' => '0312345678',
        'citizenId' => '',
        'address' => '123 Nguyễn Huệ, TP.HCM',
        'email' => '[email protected]',
        'phone' => '0901234567',
    ],
    'items' => [[
        'itemCode' => 'DV001',
        'itemGroupCode' => 'API_GROUP_SOFTWARE',
        'sourceProductName' => 'Gói phần mềm Pro',
        'itemName' => 'Dịch vụ phần mềm',
        'unit' => 'Tháng',
        'quantity' => 1,
        'unitPrice' => 100000,
        'taxRate' => 10,
    ]],
    'invoiceOptions' => [
        'requested' => true,
        'buyerNotTakingInvoice' => false,
        'paymentMethod' => 'Chuyển khoản',
        'note' => '',
        'source' => 'api',
    ],
];

$metadataJson = json_encode(
    $metadata,
    JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_THROW_ON_ERROR
);
$extraData = base64_encode($metadataJson);

$rawSignature = "accessKey={$accessKey}"
    . "&amount={$amount}"
    . '&bankAccounts=Array'
    . "&extraData={$extraData}"
    . "&ipnUrl={$ipnUrl}"
    . "&orderId={$orderId}"
    . "&orderInfo={$orderInfo}"
    . "&partnerCode={$partnerCode}"
    . "&redirectUrl={$redirectUrl}"
    . "&requestId={$requestId}"
    . "&requestType={$requestType}"
    . '&signatureVersion=2';

$payload = [
    'accessKey' => $accessKey,
    'partnerCode' => $partnerCode,
    'partnerName' => 'CÔNG TY TNHH ABC',
    'requestId' => $requestId,
    'amount' => $amount,
    'orderId' => $orderId,
    'orderInfo' => $orderInfo,
    'orderType' => $requestType,
    'bankAccounts' => $bankAccounts,
    'redirectUrl' => $redirectUrl,
    'ipnUrl' => $ipnUrl,
    'requestType' => $requestType,
    'signatureVersion' => '2',
    'extraData' => $extraData,
    'signature' => hash_hmac('sha256', $rawSignature, $secretKey),
];

$ch = curl_init($endpoint);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json; charset=UTF-8'],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),
]);

$response = curl_exec($ch);
if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}
curl_close($ch);

echo $response;

const crypto = require('crypto');
const axios = require('axios');

const endpoint = 'https://payment.pay2s.vn/v1/gateway/api/create';
const accessKey = process.env.PAY2S_ACCESS_KEY;
const secretKey = process.env.PAY2S_SECRET_KEY;
const partnerCode = process.env.PAY2S_PARTNER_CODE;

const requestId = Date.now().toString();
const orderId = `ORDER-${requestId}`;
const amount = '110000';
const orderInfo = `TT${requestId}`;
const requestType = 'pay2s';
const redirectUrl = 'https://merchant.example/return';
const ipnUrl = 'https://merchant.example/pay2s/ipn';
const bankAccounts = [{ account_number: '99999999', bank_id: 'ACB' }];

const metadata = {
  invoiceType: 'vat',
  customerInfo: {
    buyerContactName: 'NGUYỄN VĂN A',
    buyerCompanyName: 'CÔNG TY TNHH ABC',
    taxCode: '0312345678',
    citizenId: '',
    address: '123 Nguyễn Huệ, TP.HCM',
    email: '[email protected]',
    phone: '0901234567'
  },
  items: [{
    itemCode: 'DV001',
    itemGroupCode: 'API_GROUP_SOFTWARE',
    externalItemId: 'ORDER_LINE_001',
    sourceProductName: 'Gói phần mềm Pro',
    itemName: 'Dịch vụ phần mềm',
    unit: 'Tháng',
    quantity: 1,
    unitPrice: 100000,
    taxRate: 10
  }],
  invoiceOptions: {
    requested: true,
    buyerNotTakingInvoice: false,
    paymentMethod: 'Chuyển khoản',
    note: '',
    source: 'api'
  }
};

const extraData = Buffer.from(JSON.stringify(metadata), 'utf8').toString('base64');
const rawSignature =
  `accessKey=${accessKey}` +
  `&amount=${amount}` +
  `&bankAccounts=Array` +
  `&extraData=${extraData}` +
  `&ipnUrl=${ipnUrl}` +
  `&orderId=${orderId}` +
  `&orderInfo=${orderInfo}` +
  `&partnerCode=${partnerCode}` +
  `&redirectUrl=${redirectUrl}` +
  `&requestId=${requestId}` +
  `&requestType=${requestType}` +
  `&signatureVersion=2`;

const signature = crypto
  .createHmac('sha256', secretKey)
  .update(rawSignature, 'utf8')
  .digest('hex');

const payload = {
  accessKey,
  partnerCode,
  partnerName: 'CÔNG TY TNHH ABC',
  requestId,
  amount,
  orderId,
  orderInfo,
  orderType: requestType,
  bankAccounts,
  redirectUrl,
  ipnUrl,
  requestType,
  signatureVersion: '2',
  extraData,
  signature
};

axios.post(endpoint, payload, {
  headers: { 'Content-Type': 'application/json; charset=UTF-8' }
}).then(({ data }) => {
  console.log(data);
});

using System.Net.Http.Json;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;

const string endpoint = "https://payment.pay2s.vn/v1/gateway/api/create";
string accessKey = Environment.GetEnvironmentVariable("PAY2S_ACCESS_KEY")!;
string secretKey = Environment.GetEnvironmentVariable("PAY2S_SECRET_KEY")!;
string partnerCode = Environment.GetEnvironmentVariable("PAY2S_PARTNER_CODE")!;

string requestId = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds().ToString();
string orderId = $"ORDER-{requestId}";
string amount = "110000";
string orderInfo = $"TT{requestId}";
string requestType = "pay2s";
string redirectUrl = "https://merchant.example/return";
string ipnUrl = "https://merchant.example/pay2s/ipn";
var bankAccounts = new[] { new { account_number = "99999999", bank_id = "ACB" } };

var metadata = new
{
    invoiceType = "vat",
    customerInfo = new
    {
        buyerContactName = "NGUYỄN VĂN A",
        buyerCompanyName = "CÔNG TY TNHH ABC",
        taxCode = "0312345678",
        citizenId = "",
        address = "123 Nguyễn Huệ, TP.HCM",
        email = "[email protected]",
        phone = "0901234567"
    },
    items = new[]
    {
        new
        {
            itemCode = "DV001",
            itemGroupCode = "API_GROUP_SOFTWARE",
            sourceProductName = "Gói phần mềm Pro",
            itemName = "Dịch vụ phần mềm",
            unit = "Tháng",
            quantity = 1,
            unitPrice = 100000,
            taxRate = 10
        }
    },
    invoiceOptions = new
    {
        requested = true,
        buyerNotTakingInvoice = false,
        paymentMethod = "Chuyển khoản",
        note = "",
        source = "api"
    }
};

string metadataJson = JsonSerializer.Serialize(metadata);
string extraData = Convert.ToBase64String(Encoding.UTF8.GetBytes(metadataJson));
string rawSignature = $"accessKey={accessKey}"
    + $"&amount={amount}"
    + "&bankAccounts=Array"
    + $"&extraData={extraData}"
    + $"&ipnUrl={ipnUrl}"
    + $"&orderId={orderId}"
    + $"&orderInfo={orderInfo}"
    + $"&partnerCode={partnerCode}"
    + $"&redirectUrl={redirectUrl}"
    + $"&requestId={requestId}"
    + $"&requestType={requestType}"
    + "&signatureVersion=2";

using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(secretKey));
string signature = Convert.ToHexString(
    hmac.ComputeHash(Encoding.UTF8.GetBytes(rawSignature))
).ToLowerInvariant();

var payload = new
{
    accessKey,
    partnerCode,
    partnerName = "CÔNG TY TNHH ABC",
    requestId,
    amount,
    orderId,
    orderInfo,
    orderType = requestType,
    bankAccounts,
    redirectUrl,
    ipnUrl,
    requestType,
    signatureVersion = "2",
    extraData,
    signature
};

using var http = new HttpClient();
var response = await http.PostAsJsonAsync(endpoint, payload);
Console.WriteLine(await response.Content.ReadAsStringAsync());

import base64
import hashlib
import hmac
import json
import os
import time

import requests

endpoint = "https://payment.pay2s.vn/v1/gateway/api/create"
access_key = os.environ["PAY2S_ACCESS_KEY"]
secret_key = os.environ["PAY2S_SECRET_KEY"]
partner_code = os.environ["PAY2S_PARTNER_CODE"]

request_id = str(int(time.time() * 1000))
order_id = f"ORDER-{request_id}"
amount = "110000"
order_info = f"TT{request_id}"
request_type = "pay2s"
redirect_url = "https://merchant.example/return"
ipn_url = "https://merchant.example/pay2s/ipn"
bank_accounts = [{"account_number": "99999999", "bank_id": "ACB"}]

metadata = {
    "invoiceType": "vat",
    "customerInfo": {
        "buyerContactName": "NGUYỄN VĂN A",
        "buyerCompanyName": "CÔNG TY TNHH ABC",
        "taxCode": "0312345678",
        "citizenId": "",
        "address": "123 Nguyễn Huệ, TP.HCM",
        "email": "[email protected]",
        "phone": "0901234567",
    },
    "items": [{
        "itemCode": "DV001",
        "itemGroupCode": "API_GROUP_SOFTWARE",
        "sourceProductName": "Gói phần mềm Pro",
        "itemName": "Dịch vụ phần mềm",
        "unit": "Tháng",
        "quantity": 1,
        "unitPrice": 100000,
        "taxRate": 10,
    }],
    "invoiceOptions": {
        "requested": True,
        "buyerNotTakingInvoice": False,
        "paymentMethod": "Chuyển khoản",
        "note": "",
        "source": "api",
    },
}

metadata_json = json.dumps(
    metadata, ensure_ascii=False, separators=(",", ":")
).encode("utf-8")
extra_data = base64.b64encode(metadata_json).decode("ascii")
raw_signature = (
    f"accessKey={access_key}"
    f"&amount={amount}"
    "&bankAccounts=Array"
    f"&extraData={extra_data}"
    f"&ipnUrl={ipn_url}"
    f"&orderId={order_id}"
    f"&orderInfo={order_info}"
    f"&partnerCode={partner_code}"
    f"&redirectUrl={redirect_url}"
    f"&requestId={request_id}"
    f"&requestType={request_type}"
    "&signatureVersion=2"
)
signature = hmac.new(
    secret_key.encode("utf-8"), raw_signature.encode("utf-8"), hashlib.sha256
).hexdigest()

payload = {
    "accessKey": access_key,
    "partnerCode": partner_code,
    "partnerName": "CÔNG TY TNHH ABC",
    "requestId": request_id,
    "amount": amount,
    "orderId": order_id,
    "orderInfo": order_info,
    "orderType": request_type,
    "bankAccounts": bank_accounts,
    "redirectUrl": redirect_url,
    "ipnUrl": ipn_url,
    "requestType": request_type,
    "signatureVersion": "2",
    "extraData": extra_data,
    "signature": signature,
}

response = requests.post(endpoint, json=payload, timeout=30)
response.raise_for_status()
print(response.json())

// Yêu cầu Java 11+ và thư viện Gson.
import com.google.gson.Gson;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.time.Instant;
import java.util.Base64;
import java.util.List;
import java.util.Map;
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;

public class Pay2SCollectionLinkV2 {
    private static String hex(byte[] bytes) {
        StringBuilder result = new StringBuilder();
        for (byte value : bytes) result.append(String.format("%02x", value));
        return result.toString();
    }

    public static void main(String[] args) throws Exception {
        String endpoint = "https://payment.pay2s.vn/v1/gateway/api/create";
        String accessKey = System.getenv("PAY2S_ACCESS_KEY");
        String secretKey = System.getenv("PAY2S_SECRET_KEY");
        String partnerCode = System.getenv("PAY2S_PARTNER_CODE");
        String requestId = String.valueOf(Instant.now().toEpochMilli());
        String orderId = "ORDER-" + requestId;
        String amount = "110000";
        String orderInfo = "TT" + requestId;
        String requestType = "pay2s";
        String redirectUrl = "https://merchant.example/return";
        String ipnUrl = "https://merchant.example/pay2s/ipn";
        List<Map<String, Object>> bankAccounts = List.of(
            Map.of("account_number", "99999999", "bank_id", "ACB")
        );

        Map<String, Object> metadata = Map.of(
            "invoiceType", "vat",
            "customerInfo", Map.of(
                "buyerContactName", "NGUYỄN VĂN A",
                "buyerCompanyName", "CÔNG TY TNHH ABC",
                "taxCode", "0312345678",
                "citizenId", "",
                "address", "123 Nguyễn Huệ, TP.HCM",
                "email", "[email protected]",
                "phone", "0901234567"
            ),
            "items", List.of(Map.of(
                "itemCode", "DV001",
                "itemGroupCode", "API_GROUP_SOFTWARE",
                "sourceProductName", "Gói phần mềm Pro",
                "itemName", "Dịch vụ phần mềm",
                "unit", "Tháng",
                "quantity", 1,
                "unitPrice", 100000,
                "taxRate", 10
            )),
            "invoiceOptions", Map.of(
                "requested", true,
                "buyerNotTakingInvoice", false,
                "paymentMethod", "Chuyển khoản",
                "note", "",
                "source", "api"
            )
        );

        Gson gson = new Gson();
        String extraData = Base64.getEncoder().encodeToString(
            gson.toJson(metadata).getBytes(StandardCharsets.UTF_8)
        );
        String rawSignature = "accessKey=" + accessKey
            + "&amount=" + amount
            + "&bankAccounts=Array"
            + "&extraData=" + extraData
            + "&ipnUrl=" + ipnUrl
            + "&orderId=" + orderId
            + "&orderInfo=" + orderInfo
            + "&partnerCode=" + partnerCode
            + "&redirectUrl=" + redirectUrl
            + "&requestId=" + requestId
            + "&requestType=" + requestType
            + "&signatureVersion=2";

        Mac mac = Mac.getInstance("HmacSHA256");
        mac.init(new SecretKeySpec(secretKey.getBytes(StandardCharsets.UTF_8), "HmacSHA256"));
        String signature = hex(mac.doFinal(rawSignature.getBytes(StandardCharsets.UTF_8)));

        Map<String, Object> payload = Map.ofEntries(
            Map.entry("accessKey", accessKey),
            Map.entry("partnerCode", partnerCode),
            Map.entry("partnerName", "CÔNG TY TNHH ABC"),
            Map.entry("requestId", requestId),
            Map.entry("amount", amount),
            Map.entry("orderId", orderId),
            Map.entry("orderInfo", orderInfo),
            Map.entry("orderType", requestType),
            Map.entry("bankAccounts", bankAccounts),
            Map.entry("redirectUrl", redirectUrl),
            Map.entry("ipnUrl", ipnUrl),
            Map.entry("requestType", requestType),
            Map.entry("signatureVersion", "2"),
            Map.entry("extraData", extraData),
            Map.entry("signature", signature)
        );

        HttpRequest request = HttpRequest.newBuilder(URI.create(endpoint))
            .header("Content-Type", "application/json; charset=UTF-8")
            .POST(HttpRequest.BodyPublishers.ofString(gson.toJson(payload)))
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient().send(
            request, HttpResponse.BodyHandlers.ofString()
        );
        System.out.println(response.body());
    }
}

package main

import (
	"bytes"
	"crypto/hmac"
	"crypto/sha256"
	"encoding/base64"
	"encoding/hex"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
	"strconv"
	"time"
)

func main() {
	endpoint := "https://payment.pay2s.vn/v1/gateway/api/create"
	accessKey := os.Getenv("PAY2S_ACCESS_KEY")
	secretKey := os.Getenv("PAY2S_SECRET_KEY")
	partnerCode := os.Getenv("PAY2S_PARTNER_CODE")
	requestID := strconv.FormatInt(time.Now().UnixMilli(), 10)
	orderID := "ORDER-" + requestID
	amount := "110000"
	orderInfo := "TT" + requestID
	requestType := "pay2s"
	redirectURL := "https://merchant.example/return"
	ipnURL := "https://merchant.example/pay2s/ipn"
	bankAccounts := []map[string]any{{"account_number": "99999999", "bank_id": "ACB"}}

	metadata := map[string]any{
		"invoiceType": "vat",
		"customerInfo": map[string]any{
			"buyerContactName": "NGUYỄN VĂN A",
			"buyerCompanyName": "CÔNG TY TNHH ABC",
			"taxCode": "0312345678",
			"citizenId": "",
			"address": "123 Nguyễn Huệ, TP.HCM",
			"email": "[email protected]",
			"phone": "0901234567",
		},
		"items": []map[string]any{{
			"itemCode": "DV001", "itemGroupCode": "API_GROUP_SOFTWARE",
			"sourceProductName": "Gói phần mềm Pro",
			"itemName": "Dịch vụ phần mềm", "unit": "Tháng",
			"quantity": 1, "unitPrice": 100000, "taxRate": 10,
		}},
		"invoiceOptions": map[string]any{
			"requested": true, "buyerNotTakingInvoice": false,
			"paymentMethod": "Chuyển khoản", "note": "", "source": "api",
		},
	}

	metadataJSON, _ := json.Marshal(metadata)
	extraData := base64.StdEncoding.EncodeToString(metadataJSON)
	rawSignature := "accessKey=" + accessKey +
		"&amount=" + amount +
		"&bankAccounts=Array" +
		"&extraData=" + extraData +
		"&ipnUrl=" + ipnURL +
		"&orderId=" + orderID +
		"&orderInfo=" + orderInfo +
		"&partnerCode=" + partnerCode +
		"&redirectUrl=" + redirectURL +
		"&requestId=" + requestID +
		"&requestType=" + requestType +
		"&signatureVersion=2"

	mac := hmac.New(sha256.New, []byte(secretKey))
	mac.Write([]byte(rawSignature))
	signature := hex.EncodeToString(mac.Sum(nil))
	payload := map[string]any{
		"accessKey": accessKey, "partnerCode": partnerCode,
		"partnerName": "CÔNG TY TNHH ABC", "requestId": requestID,
		"amount": amount, "orderId": orderID, "orderInfo": orderInfo,
		"orderType": requestType, "bankAccounts": bankAccounts,
		"redirectUrl": redirectURL, "ipnUrl": ipnURL,
		"requestType": requestType, "signatureVersion": "2",
		"extraData": extraData, "signature": signature,
	}

	body, _ := json.Marshal(payload)
	response, err := http.Post(endpoint, "application/json; charset=UTF-8", bytes.NewReader(body))
	if err != nil { panic(err) }
	defer response.Body.Close()
	result, _ := io.ReadAll(response.Body)
	fmt.Println(string(result))
}

require 'base64'
require 'json'
require 'net/http'
require 'openssl'
require 'time'

endpoint = URI('https://payment.pay2s.vn/v1/gateway/api/create')
access_key = ENV.fetch('PAY2S_ACCESS_KEY')
secret_key = ENV.fetch('PAY2S_SECRET_KEY')
partner_code = ENV.fetch('PAY2S_PARTNER_CODE')

request_id = (Time.now.to_f * 1000).to_i.to_s
order_id = "ORDER-#{request_id}"
amount = '110000'
order_info = "TT#{request_id}"
request_type = 'pay2s'
redirect_url = 'https://merchant.example/return'
ipn_url = 'https://merchant.example/pay2s/ipn'
bank_accounts = [{ account_number: '99999999', bank_id: 'ACB' }]

metadata = {
  invoiceType: 'vat',
  customerInfo: {
    buyerContactName: 'NGUYỄN VĂN A',
    buyerCompanyName: 'CÔNG TY TNHH ABC',
    taxCode: '0312345678',
    citizenId: '',
    address: '123 Nguyễn Huệ, TP.HCM',
    email: '[email protected]',
    phone: '0901234567'
  },
  items: [{
    itemCode: 'DV001',
    itemGroupCode: 'API_GROUP_SOFTWARE',
    sourceProductName: 'Gói phần mềm Pro',
    itemName: 'Dịch vụ phần mềm',
    unit: 'Tháng',
    quantity: 1,
    unitPrice: 100000,
    taxRate: 10
  }],
  invoiceOptions: {
    requested: true,
    buyerNotTakingInvoice: false,
    paymentMethod: 'Chuyển khoản',
    note: '',
    source: 'api'
  }
}

extra_data = Base64.strict_encode64(JSON.generate(metadata).encode('UTF-8'))
raw_signature = "accessKey=#{access_key}" \
  "&amount=#{amount}" \
  '&bankAccounts=Array' \
  "&extraData=#{extra_data}" \
  "&ipnUrl=#{ipn_url}" \
  "&orderId=#{order_id}" \
  "&orderInfo=#{order_info}" \
  "&partnerCode=#{partner_code}" \
  "&redirectUrl=#{redirect_url}" \
  "&requestId=#{request_id}" \
  "&requestType=#{request_type}" \
  '&signatureVersion=2'
signature = OpenSSL::HMAC.hexdigest('SHA256', secret_key, raw_signature)

payload = {
  accessKey: access_key,
  partnerCode: partner_code,
  partnerName: 'CÔNG TY TNHH ABC',
  requestId: request_id,
  amount: amount,
  orderId: order_id,
  orderInfo: order_info,
  orderType: request_type,
  bankAccounts: bank_accounts,
  redirectUrl: redirect_url,
  ipnUrl: ipn_url,
  requestType: request_type,
  signatureVersion: '2',
  extraData: extra_data,
  signature: signature
}

request = Net::HTTP::Post.new(endpoint)
request['Content-Type'] = 'application/json; charset=UTF-8'
request.body = JSON.generate(payload)
response = Net::HTTP.start(endpoint.host, endpoint.port, use_ssl: true) do |http|
  http.request(request)
end
puts response.body