Providers (International)

Get available countries, operators, and denominations for international top-up.

Endpoint: POST /providers

Get Countries

Request without parameters returns all available countries.

cURL

curl -X POST https://api.paynet.one/providers \
  -H "Content-Type: application/json" \
  -d '{
    "auth": {
      "id": 123,
      "key": 1706360400000,
      "hash": "a1b2c3d4e5f6..."
    }
  }'

PHP

<?php
$response = apiRequest('/providers', []);
print_r($response);

Node.js

const response = await api.post('/providers', { auth });
console.log(response.countries);

Python

response = api.post('/providers', {'auth': auth_data})
print(response['countries'])

Response

{
  "countries": [
    {
      "id": "74",
      "name": "Pakistan",
      "phone_code": "+92"
    },
    {
      "id": "110",
      "name": "Uganda",
      "phone_code": "+256"
    },
    {
      "id": "17",
      "name": "Burundi",
      "phone_code": "+257"
    }
  ]
}

Get Operators by Country

Pass country_id to get operators in that country.

cURL

curl -X POST https://api.paynet.one/providers \
  -H "Content-Type: application/json" \
  -d '{
    "auth": {
      "id": 123,
      "key": 1706360400001,
      "hash": "b2c3d4e5f6a1..."
    },
    "country_id": 74
  }'

Node.js

const response = await api.post('/providers', {
  auth,
  country_id: 74
});
console.log(response.providers);

Response

{
  "country": {
    "id": "74",
    "name": "Pakistan"
  },
  "providers": [
    {
      "id": "46",
      "parent_id": 0,
      "name": "Ufone Pakistan",
      "logo": "https://bo.paynet.one/uploads/operator-logo/46.png",
      "is_pin_based": false
    },
    {
      "id": "47",
      "parent_id": 0,
      "name": "Jazz Pakistan",
      "logo": "https://bo.paynet.one/uploads/operator-logo/47.png",
      "is_pin_based": false
    }
  ]
}

Field	Description
id	Operator ID (use in next request)
parent_id	Parent operator (0 = root)
name	Operator name
logo	Operator logo URL
is_pin_based	Whether this returns a PIN

Get Denominations by Operator

Pass provider_id to get available denominations.

cURL

curl -X POST https://api.paynet.one/providers \
  -H "Content-Type: application/json" \
  -d '{
    "auth": {
      "id": 123,
      "key": 1706360400002,
      "hash": "c3d4e5f6a1b2..."
    },
    "provider_id": 46
  }'

Node.js

const response = await api.post('/providers', {
  auth,
  provider_id: 46
});
console.log(response.amounts);

Response

{
  "country": {
    "id": "74",
    "name": "Pakistan"
  },
  "providers": [
    {
      "id": "46",
      "parent_id": 0,
      "name": "Ufone Pakistan"
    }
  ],
  "amounts": [
    {
      "type_id": 1,
      "amount": 100.00,
      "currency": "PKR",
      "sale_price": 5.00,
      "sale_currency": "AED",
      "price": 4.95,
      "price_currency": "AED"
    },
    {
      "type_id": 1,
      "amount": 500.00,
      "currency": "PKR",
      "sale_price": 25.00,
      "sale_currency": "AED",
      "price": 24.75,
      "price_currency": "AED"
    },
    {
      "type_id": 2,
      "amount": 1000.00,
      "currency": "PKR",
      "sale_price": 45.00,
      "sale_currency": "AED",
      "price": 44.55,
      "price_currency": "AED"
    }
  ]
}

Amount Fields

Field	Description
type_id	Denomination type (1=Mobile, 2=Data, etc.)
amount	Value customer receives
currency	Customer's currency
sale_price	Suggested retail price
sale_currency	Your currency
price	Your cost (with discount)
price_currency	Your currency

Denomination Types

type_id	Type
1	Mobile
2	Data / Bundle / Package

Next Step

After discovering available denominations, proceed to Check with the phone number.