Check (International)

Validate the phone number and lock the selected amount.

Endpoint: POST /transaction/check

Request

Use product: "international-bridge" for all international top-ups. Pass the amount_id from the Provider response and the recipient phone number.

cURL

curl -X POST https://API-ENDPOINT/transaction/check \
  -H "Content-Type: application/json" \
  -d '{
    "auth": {
      "id": 123,
      "key": 1706360400000,
      "hash": "a1b2c3d4e5f6..."
    },
    "product": "international-bridge",
    "fields": {
      "amount_id": "389c9b72d2677970916fac310a36e5a4",
      "account": "911234567890"
    }
  }'

PHP

<?php
$url = 'https://API-ENDPOINT/transaction/check';
$key = time() * 1000;

$data = [
    'auth' => [
        'id' => 123,
        'key' => $key,
        'hash' => md5(123 . $token . $key)
    ],
    'product' => 'international-bridge',
    'fields' => [
        'amount_id' => '389c9b72d2677970916fac310a36e5a4',
        'account' => '911234567890'
    ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

Node.js

const key = Date.now();
const hash = md5(`123${token}${key}`);

const response = await fetch('https://API-ENDPOINT/transaction/check', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    auth: { id: 123, key, hash },
    product: 'international-bridge',
    fields: {
      amount_id: '389c9b72d2677970916fac310a36e5a4',
      account: '911234567890'
    }
  })
});

const data = await response.json();
console.log(data);

Python

import requests
import hashlib
import time

url = 'https://API-ENDPOINT/transaction/check'
key = int(time.time() * 1000)
hash_value = hashlib.md5(f"123{token}{key}".encode()).hexdigest()

response = requests.post(url, json={
    'auth': {
        'id': 123,
        'key': key,
        'hash': hash_value
    },
    'product': 'international-bridge',
    'fields': {
        'amount_id': '389c9b72d2677970916fac310a36e5a4',
        'account': '911234567890'
    }
})

print(response.json())

Request Fields

Field	Type	Required	Description
product	string	Yes	Always "international-bridge"
fields.amount_id	string	Yes	Amount ID from Provider response
fields.account	string	Yes	Recipient phone number (with country code, no +)
simulation	integer	No	Set to 1 for test mode

Response

{
  "transaction": {
    "id": "69d-7c9-5f1-098-494",
    "state": -1,
    "time": "2026-04-09 19:44:31",
    "service": {
      "id": "international-bridge",
      "name": "International Bridge"
    },
    "account": "911234567890",
    "country_id": "IND",
    "country_name": "India",
    "provider_id": 284,
    "provider_name": "MTNL",
    "amount_id": "389c9b72d2677970916fac310a36e5a4",
    "amount": "100",
    "amount_currency": "INR",
    "price": "4.56",
    "price_currency": "AED"
  }
}

Response Fields

Field	Type	Description
transaction.id	string	Paynet transaction ID (use in Confirm)
transaction.state	integer	See Transaction States
transaction.account	string	Recipient phone number
transaction.amount	string	Value in local currency
transaction.amount_currency	string	Local currency code
transaction.price	string	Amount to be deducted from your wallet
transaction.price_currency	string	Your wallet currency
transaction.country_id	string	Detected country ISO code
transaction.country_name	string	Detected country name
transaction.provider_id	integer	Detected operator ID
transaction.provider_name	string	Detected operator name
transaction.amount_id	string	Selected amount ID

Next Step

Proceed to Confirm with the transaction.id from this response.