Get List Services

GET /openapi/v1/services

This API acts as a "service configuration directory", listing all payment gateways and services (e.g. BIDV QR, VCCB QR) currently activated for the Merchant.

Query the list of licensed services and payment gateways. Returns the service_code values needed for use in other APIs (such as creating a VA).

No encryption required — Unlike other APIs, this API does not require payload encryption. Parameters are passed directly in the URL.

---

cURL

curl --location '<base_url>/openapi/v1/services?service_type=finance' \
  --header 'Partner-Code: 1111111' \
  --header 'Authorization: Bearer eyJhbGciOiJ...'

Python

import requests

url = "<base_url>/openapi/v1/services"

params = {"service_type": "finance"}
headers = {
    "Partner-Code": "1111111",
    "Authorization": "Bearer eyJhbGciOiJ...",
}

response = requests.get(url, headers=headers, params=params)
print(response.text)

Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "<base_url>/openapi/v1/services?service_type=finance"

	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Set("Partner-Code", "1111111")
	req.Header.Set("Authorization", "Bearer eyJhbGciOiJ...")

	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()

	result, _ := io.ReadAll(resp.Body)
	fmt.Println(string(result))
}

JavaScript

const response = await fetch(
  "<base_url>/openapi/v1/services?service_type=finance",
  {
    method: "GET",
    headers: {
      "Partner-Code": "1111111",
      "Authorization": "Bearer eyJhbGciOiJ...",
    },
  }
);

const result = await response.text();
console.log(result);

Request

Headers

Name	Required	Description
Partner-Code	✅	Customer code (provided by TCONNECT)
Authorization	✅	Bearer <access_token>

Query Parameters

Name	Type	Required	Description
service_type	string		Service type (e.g. finance)
payment_method	string		Payment method (qr, card...)
code	string		Specific service code to filter by
limit	number	✅	Maximum number of records
page	number	✅	Page number (starting from 1)

Response

200 — Service list

Field	Type	Description
data	array	List of services
data[].code	string	service_code used in other APIs
data[].name	string	Display name of the service
data[].payment_method	string	Supported payment method
data[].allowed_va_creation	boolean	Flag indicating whether VA creation is allowed
data[].provider.provider_code	string	Provider code
data[].provider.provider_name	string	Provider name
pagination.page	integer	Current page
pagination.limit	integer	Records per page
pagination.total_items	integer	Total number of records
pagination.total_pages	integer	Total number of pages

Response Example

{
  "data": [
    {
      "id": 28,
      "code": "bidv-qr",
      "name": "QR Payment Service - BIDV",
      "service_type": "finance",
      "payment_method": "qr",
      "allowed_va_creation": false,
      "provider": {
        "provider_code": "bidv",
        "provider_name": "BIDV"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total_items": 1,
    "total_pages": 1
  }
}