Distribution

Validate Product

This document outlines the APIs, workflow, and integration guidelines for foreign partners offering wallet-based top-ups (e.g., credits, diamonds, or tokens) to customers in India via Transact Bridge’s reseller/distribution infrastructure.

Transact Bridge acts as the reseller and fulfillment partner for international digital goods providers. This integration enables instant digital delivery of top-ups to Indian users using an automatic delivery system, automatic payment routing through Indian MOR, reconciliation, and transparent invoicing.

To ensure that the top-up is sent to the correct and valid user, this API is used to verify the end user’s account before processing the transaction. It checks whether the user exists on the merchant’s platform and can receive the selected top-up (SKU).

Note: If the validation is successful, the API returns an orderId (generated by CODA). This orderId must be included in the next step — the Request for Payment API — to proceed with the purchase.

POST

webstore

v1.0

validateProductTopupDetails

Validate Product

curl --request POST \
  --url https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-signature: <api-key>' \
  --data '
{
  "productReferenceId": "<string>",
  "userId": "<string>"
}
'

import requests

url = "https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails"

payload = {
    "productReferenceId": "<string>",
    "userId": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "x-signature": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<api-key>',
    'x-signature': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({productReferenceId: '<string>', userId: '<string>'})
};

fetch('https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'productReferenceId' => '<string>',
    'userId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>",
    "x-signature: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails"

	payload := strings.NewReader("{\n  \"productReferenceId\": \"<string>\",\n  \"userId\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-signature", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails")
  .header("x-api-key", "<api-key>")
  .header("x-signature", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"productReferenceId\": \"<string>\",\n  \"userId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["x-signature"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"productReferenceId\": \"<string>\",\n  \"userId\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "sub_status": "<string>",
  "data": {}
}

Authorizations

x-api-key

string

header

required

Merchant API Key

x-signature

string

header

required

Generated request signature

Body

application/json

productReferenceId

string

required

Product Reference ID of the SKU

userId

string

UserId of the customer, which checks if it exists on the merchant’s platform, and can receive the selected top-up (SKU)

Response

200 - application/json

Contains the orderId and clientId to be used to create a payment session.

status

string

The response from the API

sub_status

string

Used for internal purposes only

data

object

Contains the orderId and clientId to be used to create a payment session.

Validate Product

curl --request POST \
  --url https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-signature: <api-key>' \
  --data '
{
  "productReferenceId": "<string>",
  "userId": "<string>"
}
'

import requests

url = "https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails"

payload = {
    "productReferenceId": "<string>",
    "userId": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "x-signature": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<api-key>',
    'x-signature': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({productReferenceId: '<string>', userId: '<string>'})
};

fetch('https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'productReferenceId' => '<string>',
    'userId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>",
    "x-signature: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails"

	payload := strings.NewReader("{\n  \"productReferenceId\": \"<string>\",\n  \"userId\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-signature", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails")
  .header("x-api-key", "<api-key>")
  .header("x-signature", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"productReferenceId\": \"<string>\",\n  \"userId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox-api.transactbridge.com/webstore/v1.0/validateProductTopupDetails")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["x-signature"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"productReferenceId\": \"<string>\",\n  \"userId\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "sub_status": "<string>",
  "data": {}
}

API Documentation

Session

Subscription

Mandate

Invoices

Transactions

Settlements

Customers

Products

Distribution

PACB

Others

Validate Product

Authorizations

Body

Response