Add credit

curl --request POST \
  --url https://api.liara.ir/v1/payments/pay \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 1000000
}
'

import requests

url = "https://api.liara.ir/v1/payments/pay"

payload = { "amount": 1000000 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({amount: 1000000})
};

fetch('https://api.liara.ir/v1/payments/pay', 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://api.liara.ir/v1/payments/pay",
  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([
    'amount' => 1000000
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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://api.liara.ir/v1/payments/pay"

	payload := strings.NewReader("{\n  \"amount\": 1000000\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://api.liara.ir/v1/payments/pay")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 1000000\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.liara.ir/v1/payments/pay")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": 1000000\n}"

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

{
  "url": "https://payment-gateway.example.com/pay",
  "method": "POST",
  "params": {
    "token": "<payment-token>"
  }
}

Payments

Add credit

Starts an online payment to add credit to your balance. Send the user’s browser to the returned url, using method and params, to complete the payment. When it succeeds, the amount is added to the balance.

The amount must be within the allowed minimum and maximum. If you have frozen mail servers, the amount must also cover reactivating them (see GET /v1/payments/minimum-credit). Your account must be verified. With teamID, this needs the billing.manage permission.

This endpoint is rate limited. Too many requests return 429.

POST

payments

pay

Add credit

curl --request POST \
  --url https://api.liara.ir/v1/payments/pay \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 1000000
}
'

import requests

url = "https://api.liara.ir/v1/payments/pay"

payload = { "amount": 1000000 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({amount: 1000000})
};

fetch('https://api.liara.ir/v1/payments/pay', 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://api.liara.ir/v1/payments/pay",
  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([
    'amount' => 1000000
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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://api.liara.ir/v1/payments/pay"

	payload := strings.NewReader("{\n  \"amount\": 1000000\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://api.liara.ir/v1/payments/pay")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 1000000\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.liara.ir/v1/payments/pay")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": 1000000\n}"

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

{
  "url": "https://payment-gateway.example.com/pay",
  "method": "POST",
  "params": {
    "token": "<payment-token>"
  }
}

Authorizations

Authorization

string

header

required

Send your API token as Authorization: Bearer <api-token>.

Query Parameters

teamID

string

Run the request in the context of a team you belong to, instead of your personal account. 24-character hexadecimal ID.

Pattern: ^[0-9a-fA-F]{24}$

Body

application/json

amount

integer

required

Amount to pay.

gateway

string

Payment gateway to use. Omit it to use the default gateway.

Response

The payment was created. Send the browser to url.

url

string<uri>

Payment page.

method

string

HTTP method to open url with.

params

object

Parameters to send to url, if any.

Introduction

Authentication & Account

Teams & Access

Billing & Subscription

Support & Notifications

Add credit

Authorizations

Query Parameters

Body

Response