Zoho Payments API

https://www.zoho.com/us/payments/api/v1/
Admin
The Zoho Payments API allows developers to integrate payment functionalities into their...
Tokens:144,121
Snippets:797
Trust Score:10
Update:5 months ago
Show doc for...
Tokens:
Raw
### Zoho Payments API Request Example

Source: https://www.zoho.com/us/payments/api/v1/response

Example of a GET request to retrieve a payment session, including account ID and authorization token.

```shell
$ curl --request GET \
--url 'https://payments.zoho.com/api/v1/paymentsessions/173000002315107?account_id=23137556' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
```

--------------------------------

### Get Customers with Request library (Node.js)

Source: https://www.zoho.com/us/payments/api/v1/customers

This Node.js example uses the 'request' library to make a GET request for customer records, specifying the account ID and authorization.

```JavaScript
const request = require('request');
const options = {
    method: 'GET',
    url: 'https://payments.zoho.com/api/v1/customers',
    qs: {account_id: '23137556'},
    headers: {
        Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
    }
};

request(options, function (error, response, body) {
    if (error) throw new Error(error);

    console.log(body);
});
```

--------------------------------

### Query Payments using Go http

Source: https://www.zoho.com/us/payments/api/v1/payments

This Go example shows how to make a GET request to retrieve payments using the standard net/http package. It demonstrates creating a request, adding headers, and reading the response body.

```go
package main

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

func main() {

	url := "https://payments.zoho.com/api/v1/payments?account_id=23137556"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")

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

defer res.Body.Close()

	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))
}
```

--------------------------------

### Java - OkHttpClient Request

Source: https://www.zoho.com/us/payments/api/v1/payments

Example of making a GET request using OkHttpClient in Java. Ensure OkHttpClient is included in your project dependencies.

```java
OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder()
    .url("https://payments.zoho.com/api/v1/payments/731000001449003?account_id=23137556")
    .get()
    .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
    .build(); Response response = client.newCall(request).execute();
```

--------------------------------

### C#: Get Payment Link Details

Source: https://www.zoho.com/us/payments/api/v1/payment-links

This C# example demonstrates how to fetch payment link information using HttpClient, including the Authorization header and account ID.

```csharp
var client = new HttpClient(); var request = new HttpRequestMessage {     Method = HttpMethod.Get,     RequestUri = new Uri("https://payments.zoho.com/api/v1/paymentlinks/173000002315107?account_id=23137556"),     Headers = { { "Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }, }, }; using (var response = await client.SendAsync(request)) {     response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync();     Console.WriteLine(body); }
```

--------------------------------

### Curl: Get Payment Details with Query Parameters

Source: https://www.zoho.com/us/payments/api/v1/payments

This command-line example uses curl to make a GET request for payment details, including the account ID in the URL and the Authorization header.

```bash
curl --request GET \ --url 'https://payments.zoho.com/api/v1/payments/731000001449003?account_id=23137556' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
```

--------------------------------

### Get Customer by Account ID (Ruby Net::HTTP)

Source: https://www.zoho.com/us/payments/api/v1/customers

This Ruby example demonstrates fetching customer data using Net::HTTP. SSL verification is disabled for simplicity.

```ruby
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://payments.zoho.com/api/v1/customers/173000002315107?account_id=23137556")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

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

--------------------------------

### Query Payment Method Session with http.client (Python)

Source: https://www.zoho.com/us/payments/api/v1/payment-method-session

This Python example uses the http.client library to make a GET request for payment method session details. It shows how to establish a connection, set headers, and read the response.

```Python
import http.client  conn = http.client.HTTPSConnection("payments.zoho.com")  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
  conn.request("GET", "/api/v1/paymentmethodsessions/731000001449003?account_id=23137556", headers=headers)
  res = conn.getresponse()
  data = res.read()
  print(data.decode("utf-8"))
```

--------------------------------

### Query Refunds with Ruby Net::HTTP

Source: https://www.zoho.com/us/payments/api/v1/refunds

Use Ruby's Net::HTTP library to query refunds. This example demonstrates setting up the URI, making a GET request, and handling SSL verification.

```ruby
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://payments.zoho.com/api/v1/refunds/731000001449003?account_id=23137556")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

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

--------------------------------

### Making a Request to Zoho Payments API

Source: https://www.zoho.com/us/payments/api/v1/errors

Example of how to make a GET request to the Zoho Payments API, including the necessary authorization header.

```shell
$ curl https://payments.zoho.com/api/v1/payments/731000001449003?account_id=23137556 -H 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
```

--------------------------------

### Payment Session Response Example

Source: https://www.zoho.com/us/payments/api/v1/payment-session

This is an example of a successful response when querying a payment session. It includes details about the session, currency, amount, status, and associated payments.

```json
{ "code": 0, "message": "success", "payments_session": { "payments_session_id": "1987000000724213", "currency": "USD", "amount": "100.50", "status": "succeeded", "created_time": 1708950672, "expiry_time": 1708951572, "payments": [ { "payment_id": "1987000000724215", "status": "succeeded", "created_time": 1708950672 } ], "meta_data": [ { "key": "Key1", "value": "Value1" } ], "description": "Payment for Order #12345", "invoice_number": "INV-12345", "reference_number": "reference_123", "max_retry_count": 3, "configurations": { "allowed_payment_methods": [ "ach_debit", "card" ], "hosted_page_parameters": { "phone_country_code": "IN", "phone": "5551234567", "name": "Charles", "email": "xxx@abc.com", "description": "Payment for Order #12345", "success_url": "https://example.com/success", "failure_url": "https://example.com/failure", "udf1": "example_udf_1", "udf2": "example_udf_2", "udf3": "example_udf_3", "udf4": "example_udf_4", "udf5": "example_udf_5" } } } }
```

--------------------------------

### Query Payment Method Session with Net::HTTP (Ruby)

Source: https://www.zoho.com/us/payments/api/v1/payment-method-session

This Ruby example uses Net::HTTP to make a GET request for payment method session details. It shows how to set up the URL, handle SSL, set the Authorization header, and read the response body.

```Ruby
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://payments.zoho.com/api/v1/paymentmethodsessions/731000001449003?account_id=23137556")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

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

--------------------------------

### Checkout Widget Response Example (Success)

Source: https://www.zoho.com/us/payments/api/v1/widget

This is an example of a successful response from the checkout widget after initiating a payment. It includes the payment ID and a signature if a signing key is configured.

```json
{
  "payment_id": "2299000000189035",
  "signature": "7b825220c0fac6dbed0df247c290b55b607c8f0c977686edc7e2ed733134a317",
  "message": "Payment successful!"
}
```

--------------------------------

### Create Payment Method Session with Request library (Node.js)

Source: https://www.zoho.com/us/payments/api/v1/payment-method-session

This Node.js example uses the 'request' library to create a payment method session. Make sure to install the 'request' package.

```JavaScript
const request = require('request');

const options = {
    method: 'POST',
    url: 'https://payments.zoho.com/api/v1/paymentmethodsessions',
    qs: {account_id: '23137556'},
    headers: {
        Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
        'content-type': 'application/json'
    },
    body: {field1: 'value1', field2: 'value2'},
    json: true
};

request(options, function (error, response, body) {
    if (error) throw new Error(error);

    console.log(body);
});
```

--------------------------------

### Create Customer using Go http.Client

Source: https://www.zoho.com/us/payments/api/v1/customers

This Go snippet shows how to create a customer using the standard net/http package. It constructs a POST request with appropriate headers and payload.

```go
package main

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

func main() {

	url := "https://payments.zoho.com/api/v1/customers?account_id=23137556"
	payload := strings.NewReader("{\"field1\":\"value1\",\"field2\":\"value2\"}")

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

	req.Header.Add("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
	req.Header.Add("content-type", "application/json")

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

defer res.Body.Close()

body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))
}
```

--------------------------------

### PHP - HttpRequest (PECL)

Source: https://www.zoho.com/us/payments/api/v1/payments

Example of making a GET request using the HttpRequest class, which is part of the PECL extension. Ensure the extension is installed.

```php
<?php
$request = new HttpRequest();
$request->setUrl('https://payments.zoho.com/api/v1/payments/731000001449003');
$request->setMethod(HTTP_METH_GET);
$request->setQueryData([
    'account_id' => '23137556'
]);
$request->setHeaders([
    'Authorization' => 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
]);

try {
    $response = $request->send();
    echo $response->getBody();
} catch (HttpException $ex) {
    echo $ex;
}
```

--------------------------------

### Create Customer using C# HttpClient

Source: https://www.zoho.com/us/payments/api/v1/customers

This C# snippet demonstrates creating a customer using HttpClient. It sets up the HTTP method, URI, headers, and content for the request.

```csharp
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://payments.zoho.com/api/v1/customers?account_id=23137556"),
    Headers =
    {
        { "Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" },
    },
    Content = new StringContent("{\"field1\":\"value1\",\"field2\":\"value2\"}")
    {
        Headers = 
        {
            ContentType = new MediaTypeHeaderValue("application/json")
        }
    }
};

using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}
```

--------------------------------

### Node.js HTTP Request Example

Source: https://www.zoho.com/us/payments/api/v1/payouts

Example of making a GET request to the Zoho Payments API v1 payouts endpoint using Node.js's built-in http module. This example demonstrates basic HTTP request handling.

```javascript
const http = require("https");

const options = {
  "method": "GET",
  "hostname": "payments.zoho.com",
  "port": null,
  "path": "/api/v1/payouts?account_id=23137556",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
```

--------------------------------

### Create Customer with Request library (Node.js)

Source: https://www.zoho.com/us/payments/api/v1/customers

An example using the 'request' library in Node.js to create a customer. It demonstrates setting the method, URL, query parameters, headers, and JSON body.

```javascript
const request = require('request'); const options = { method: 'POST', url: 'https://payments.zoho.com/api/v1/customers', qs: {account_id: '23137556'}, headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f', 'content-type': 'application/json' }, body: {field1: 'value1', field2: 'value2'}, json: true }; request(options, function (error, response, body) { if (error) throw new Error(error);    console.log(body); }); 
```

--------------------------------

### Get Customers with cURL (PHP)

Source: https://www.zoho.com/us/payments/api/v1/customers

This PHP example uses cURL to make a GET request to retrieve customer records, including the account ID and authorization header.

```PHP
<?php
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://payments.zoho.com/api/v1/customers?account_id=23137556",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  ],
]);

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

curl_close($curl);

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

--------------------------------

### Create Customer using Java (OkHttpClient)

Source: https://www.zoho.com/us/payments/api/v1/customer

This Java code snippet demonstrates how to create a customer using OkHttpClient. It includes setting the request URL, headers, and JSON body.

```Java
OkHttpClient client = new OkHttpClient(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}"); Request request = new Request.Builder() .url("https://payments.zoho.com/api/v1/customers?account_id=23137556") .post(body) .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .addHeader("content-type", "application/json") .build(); Response response = client.newCall(request).execute();
```

--------------------------------

### Get Customers with Node.js HTTPS module

Source: https://www.zoho.com/us/payments/api/v1/customers

This Node.js example uses the built-in 'https' module to make a GET request for customer records, specifying the account ID and authorization.

```JavaScript
const http = require("https");
const options = {
  "method": "GET",
  "hostname": "payments.zoho.com",
  "port": null,
  "path": "/api/v1/customers?account_id=23137556",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
```

--------------------------------

### Create Customer with Net::HTTP (Ruby)

Source: https://www.zoho.com/us/payments/api/v1/customers

This Ruby example uses Net::HTTP to send a POST request for customer creation. It includes setting up SSL, headers, and the request body.

```ruby
require 'uri' require 'net/http' require 'openssl'  url = URI("https://payments.zoho.com/api/v1/customers?account_id=23137556")  http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE  request = Net::HTTP::Post.new(url) request["Authorization"] = 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' request["content-type"] = 'application/json' request.body = "{\"field1\":\"value1\",\"field2\":\"value2\"}"  response = http.request(request) puts response.read_body
```

--------------------------------

### Initiate Payment with Widget

Source: https://www.zoho.com/us/payments/api/v1/widget

Initiate a payment using the widget instance. Provide essential details such as amount, currency, payment session ID, and a description. Optional fields like currency symbol, business name, default payment method, and customer address can also be included.

```javascript
instance.pay({
  "amount": "100.00",
  "transaction_type": "payment",
  "currency_code": "USD",
  "payments_session_id": "1234567890",
  "description": "Test Payment",
  "currency_symbol": "$",
  "business": "My Business",
  "payment_method": "card",
  "address": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": "1234567890"
  },
  "invoice_number": "INV-001"
});
```

--------------------------------

### Node.js Unirest Request Example

Source: https://www.zoho.com/us/payments/api/v1/payouts

Example of making a GET request to the Zoho Payments API v1 payouts endpoint using Unirest in Node.js. Unirest simplifies HTTP requests.

```javascript
const unirest = require("unirest");

const req = unirest("GET", "https://payments.zoho.com/api/v1/payouts");

req.query({
    "account_id": "23137556"
});

req.headers({
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
});

req.end(function (res) {
    if (res.error) throw new Error(res.error);

    console.log(res.body);
});
```

--------------------------------

### Create Payment Method Session using Go HTTP Client

Source: https://www.zoho.com/us/payments/api/v1/payment-method-session

This Go program demonstrates creating a payment method session using the standard net/http package. It sets up the URL, payload, and headers before making the POST request.

```go
package main

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

func main() {

	url := "https://payments.zoho.com/api/v1/paymentmethodsessions?account_id=23137556"

	payload := strings.NewReader("{\"field1\":\"value1\",\"field2\":\"value2\"}")

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

	req.Header.Add("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
	req.Header.Add("content-type", "application/json")

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

defer res.Body.Close()

body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))
}
```

--------------------------------

### Java Unirest Request Example

Source: https://www.zoho.com/us/payments/api/v1/payouts

Example of making a GET request to the Zoho Payments API v1 payouts endpoint using Unirest in Java. This requires the Unirest library to be set up.

```java
HttpResponse<String> response = Unirest.get("https://payments.zoho.com/api/v1/payouts?account_id=23137556")
    .header("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
    .asString();
```

--------------------------------

### Go HTTP Refund Request

Source: https://www.zoho.com/us/payments/api/v1/refunds

Initiate a refund using Go's standard http package. This example shows how to construct the URL with query parameters, set headers, and send the JSON payload.

```go
package main

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

func main() {

	url := "https://payments.zoho.com/api/v1/payments/731000001449003/refunds?account_id=23137556"

	payload := strings.NewReader("{\"field1\":\"value1\",\"field2\":\"value2\"}")

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

	req.Header.Add("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
	req.Header.Add("content-type", "application/json")

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

defer res.Body.Close()

body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))
}
```

--------------------------------

### Java OkHttp Request Example

Source: https://www.zoho.com/us/payments/api/v1/payouts

Example of making a GET request to the Zoho Payments API v1 payouts endpoint using OkHttp in Java. Ensure you have the OkHttp library included in your project.

```java
OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder()
    .url("https://payments.zoho.com/api/v1/payouts?account_id=23137556")
    .get()
    .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
    .build();
Response response = client.newCall(request).execute();
```

--------------------------------

### Create Customer with Unirest (Java)

Source: https://www.zoho.com/us/payments/api/v1/customers

Utilize Unirest for making POST requests to create a customer. This example demonstrates setting headers and the request body.

```java
HttpResponse<String> response = Unirest.post("https://payments.zoho.com/api/v1/customers?account_id=23137556") .header("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .header("content-type", "application/json") .body("{\"field1\":\"value1\",\"field2\":\"value2\"}") .asString();
```

--------------------------------

### Node.js Request Library Example

Source: https://www.zoho.com/us/payments/api/v1/payouts

Example of making a GET request to the Zoho Payments API v1 payouts endpoint using the 'request' library in Node.js. This library is widely used for HTTP requests.

```javascript
const request = require('request');

const options = {
    method: 'GET',
    url: 'https://payments.zoho.com/api/v1/payouts',
    qs: {account_id: '23137556'},
    headers: {
        Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
    }
};

request(options, function (error, response, body) {
    if (error) throw new Error(error);

    console.log(body);
});
```

--------------------------------

### Create Payment Link using Go HTTP Client

Source: https://www.zoho.com/us/payments/api/v1/payment-links

This Go snippet shows how to create a payment link using the standard net/http package. It sets up the URL, payload, request headers, and processes the response.

```go
package main

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

func main() {

	url := "https://payments.zoho.com/api/v1/paymentlinks?account_id=23137556"

payload := strings.NewReader("{\"field1\":\"value1\",\"field2\":\"value2\"}")

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

req.Header.Add("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
req.Header.Add("content-type", "application/json")

res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)

fmt.Println(res)
fmt.Println(string(body))
}
```

--------------------------------

### Python HTTP Client Request Example

Source: https://www.zoho.com/us/payments/api/v1/payouts

Example of making a GET request to the Zoho Payments API v1 payouts endpoint using Python's http.client. This is a standard library for HTTP communication.

```python
import http.client

conn = http.client.HTTPSConnection("payments.zoho.com")

headers = {
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}

conn.request("GET", "/api/v1/payouts?account_id=23137556", headers=headers)

res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```

--------------------------------

### Create Payment Session with Go HTTP Client

Source: https://www.zoho.com/us/payments/api/v1/payment-session

This Go program shows how to create a payment session using the standard net/http package. It constructs a POST request with a JSON payload and necessary headers.

```go
package main

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

func main() {

	url := "https://payments.zoho.com/api/v1/paymentsessions?account_id=23137556"
	payload := strings.NewReader("{\"field1\":\"value1\",\"field2\":\"value2\"}")

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

	req.Header.Add("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
	req.Header.Add("content-type", "application/json")

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

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

	fmt.Println(res)
	fmt.Println(string(body))
}
```

--------------------------------

### JavaScript jQuery AJAX Request Example

Source: https://www.zoho.com/us/payments/api/v1/payouts

Example of making a GET request to the Zoho Payments API v1 payouts endpoint using jQuery's AJAX method. Ensure jQuery is included in your project.

```javascript
const settings = { "async": true, "crossDomain": true, "url": "https://payments.zoho.com/api/v1/payouts?account_id=23137556", "method": "GET", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" } };

$.ajax(settings).done(function (response) {
  console.log(response);
});
```

--------------------------------

### Retrieve Payout Details with Query Parameters (Go)

Source: https://www.zoho.com/us/payments/api/v1/payouts

This Go program demonstrates how to fetch payout details using the standard net/http package, including the account ID in the URL.

```go
package main  import ( "fmt" "net/http" "io/ioutil" ) func main() {  	url := "https://payments.zoho.com/api/v1/payouts/193000002315107?account_id=23137556"  	req, _ := http.NewRequest("GET", url, nil)  	req.Header.Add("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")  	res, _ := http.DefaultClient.Do(req) defer res.Body.Close() 	body, _ := ioutil.ReadAll(res.Body)  	fmt.Println(res) 	fmt.Println(string(body)) }
```

--------------------------------

### Create Customer using PHP http\Client

Source: https://www.zoho.com/us/payments/api/v1/customers

This PHP snippet utilizes the http\Client and http\Client\Request classes to create a customer. It demonstrates setting up the request URL, method, body, query parameters, and headers.

```php
<?php
$client = new http\Client;
$request = new http\Client\Request;
$body = new http\Message\Body;
$body->append('{"field1":"value1","field2":"value2"}');
$request->setRequestUrl('https://payments.zoho.com/api/v1/customers');
$request->setRequestMethod('POST');
$request->setBody($body);
$request->setQuery(new http\QueryString([
    'account_id' => '23137556'
]));
$request->setHeaders([
    'Authorization' => 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
    'content-type' => 'application/json'
]);

$client->enqueue($request)->send();
$response = $client->getResponse();

echo $response->getBody();
```

--------------------------------

### JavaScript Fetch Request Example

Source: https://www.zoho.com/us/payments/api/v1/payouts

Example of making a GET request to the Zoho Payments API v1 payouts endpoint using the Fetch API in JavaScript. This is a modern approach for handling network requests in browsers and Node.js.

```javascript
const options = { method: 'GET', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' } };
fetch('https://payments.zoho.com/api/v1/payouts?account_id=23137556', options)
    .then(response => response.json())
    .then(response => console.log(response))
    .catch(err => console.error(err));
```

--------------------------------

### Node.js - Unirest Request

Source: https://www.zoho.com/us/payments/api/v1/payments

Example of making a GET request using Unirest in Node.js. Unirest simplifies HTTP requests.

```javascript
const unirest = require("unirest");
const req = unirest("GET", "https://payments.zoho.com/api/v1/payments/731000001449003");

req.query({
    "account_id": "23137556"
});

req.headers({
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
});

req.end(function (res) {
    if (res.error) throw new Error(res.error);

    console.log(res.body);
});
```

--------------------------------

### Go HTTP Request with Query Parameters

Source: https://www.zoho.com/us/payments/api/v1/payments

This Go program demonstrates making a POST request to the Zoho Payments API using the standard net/http package. It shows how to set the URL, payload, and headers.

```go
package main

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

func main() {

	url := "https://payments.zoho.com/api/v1/payments?account_id=23137556"
	payload := strings.NewReader("{\"field1\":\"value1\",\"field2\":\"value2\"}")

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

	req.Header.Add("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
	req.Header.Add("content-type", "application/json")

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

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

	fmt.Println(res)
	fmt.Println(string(body))
}
```

--------------------------------

### Initiate Refund with OkHttpClient (Java)

Source: https://www.zoho.com/us/payments/api/v1/refunds

Use OkHttpClient to send a POST request to initiate a refund. Ensure the Authorization header is correctly set.

```Java
OkHttpClient client = new OkHttpClient(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}"); Request request = new Request.Builder()
    .url("https://payments.zoho.com/api/v1/payments/731000001449003/refunds?account_id=23137556")
    .post(body)
    .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
    .addHeader("content-type", "application/json")
    .build(); Response response = client.newCall(request).execute();
```

--------------------------------

### Java - Unirest Request

Source: https://www.zoho.com/us/payments/api/v1/payments

Example of making a GET request using Unirest in Java. Unirest simplifies HTTP requests.

```java
HttpResponse<String> response = Unirest.get("https://payments.zoho.com/api/v1/payments/731000001449003")
    .header("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
    .asString();
```

--------------------------------

### Ruby Net::HTTP Request Example

Source: https://www.zoho.com/us/payments/api/v1/payouts

Example of making a GET request to the Zoho Payments API v1 payouts endpoint using Ruby's Net::HTTP library. This is part of Ruby's standard library for HTTP.

```ruby
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://payments.zoho.com/api/v1/payouts?account_id=23137556")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

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

--------------------------------

### Query Payouts using Go http.Client

Source: https://www.zoho.com/us/payments/api/v1/payouts

This Go program demonstrates how to query payouts using the standard net/http package. It creates a new request, adds the Authorization header, and prints the response body.

```go
package main

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

func main() {
	url := "https://payments.zoho.com/api/v1/payouts?account_id=23137556"

	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Add("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")

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

	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))
}
```

--------------------------------

### Python - http.client Request

Source: https://www.zoho.com/us/payments/api/v1/payments

Example of making a GET request using Python's built-in http.client. This is a lower-level HTTP client.

```python
import http.client  conn = http.client.HTTPSConnection("payments.zoho.com")  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }  conn.request("GET", "/api/v1/payments/731000001449003?account_id=23137556", headers=headers)  res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
```

--------------------------------

### PHP - cURL Request

Source: https://www.zoho.com/us/payments/api/v1/payments

Example of making a GET request using cURL in PHP. cURL is a widely used library for transferring data.

```php
<?php
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://payments.zoho.com/api/v1/payments/731000001449003?account_id=23137556",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  ],
]);

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

curl_close($curl);

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

--------------------------------

### Create Customer using Python (http.client)

Source: https://www.zoho.com/us/payments/api/v1/customer

This Python code uses the http.client library to send a POST request for customer creation. It details setting up the connection, payload, and headers.

```Python
import http.client  conn = http.client.HTTPSConnection("payments.zoho.com")  payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", 'content-type': "application/json" }  conn.request("POST", "/api/v1/customers?account_id=23137556", payload, headers)  res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
```

--------------------------------

### Create Customer using Javascript (Fetch API)

Source: https://www.zoho.com/us/payments/api/v1/customer

Example of creating a customer using the Fetch API in Javascript. This snippet shows how to configure the request method, headers, and body.

```Javascript
const options = { method: 'POST', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f', 'content-type': 'application/json' }, body: '{"field1":"value1","field2":"value2"}' }; fetch('https://payments.zoho.com/api/v1/customers?account_id=23137556', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
```

--------------------------------

### Node.js - HTTPS Module Request

Source: https://www.zoho.com/us/payments/api/v1/payments

Example of making a GET request using Node.js's built-in https module. Suitable for server-side JavaScript.

```javascript
const http = require("https"); const options = {
    "method": "GET",
    "hostname": "payments.zoho.com",
    "port": null,
    "path": "/api/v1/payments/731000001449003?account_id=23137556",
    "headers": {
        "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
    }
};

const req = http.request(options, function (res) {
    const chunks = [];

    res.on("data", function (chunk) {
        chunks.push(chunk);
    });

    res.on("end", function () {
        const body = Buffer.concat(chunks);
        console.log(body.toString());
    });
});

req.end();
```

--------------------------------

### Create Payment Session with request library (Node.js)

Source: https://www.zoho.com/us/payments/api/v1/payment-session

This Node.js example uses the 'request' library to create a payment session. Ensure the 'qs' object contains the account_id and the Authorization header is correctly formatted.

```JavaScript
const request = require('request');
const options = {
    method: 'POST',
    url: 'https://payments.zoho.com/api/v1/paymentsessions',
    qs: {account_id: '23137556'},
    headers: {
        Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
        'content-type': 'application/json'
    },
    body: {field1: 'value1', field2: 'value2'},
    json: true
};

request(options, function (error, response, body) {
    if (error) throw new Error(error);

    console.log(body);
});
```

--------------------------------

### JavaScript - jQuery AJAX Request

Source: https://www.zoho.com/us/payments/api/v1/payments

Example of making a GET request using jQuery's AJAX method. Requires jQuery to be included in your project.

```javascript
const settings = { "async": true, "crossDomain": true, "url": "https://payments.zoho.com/api/v1/payments/731000001449003?account_id=23137556", "method": "GET", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" } };  $.ajax(settings).done(function (response) {   console.log(response); });
```

--------------------------------

### Create Payment Session with C# HttpClient

Source: https://www.zoho.com/us/payments/api/v1/payment-session

This C# example demonstrates creating a payment session using HttpClient. It involves setting up an HttpRequestMessage with the correct URI, method, headers, and JSON content.

```csharp
var client = new HttpClient();
var request = new HttpRequestMessage {
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://payments.zoho.com/api/v1/paymentsessions?account_id=23137556"),
    Headers = {
        { "Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" },
    },
    Content = new StringContent("{\"field1\":\"value1\",\"field2\":\"value2\"}") {
        Headers = {
            ContentType = new MediaTypeHeaderValue("application/json")
        }
    }
};

using (var response = await client.SendAsync(request)) {
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}
```

--------------------------------

### JavaScript - Fetch API Request

Source: https://www.zoho.com/us/payments/api/v1/payments

Example of making a GET request using the Fetch API in JavaScript. This is a modern approach for handling network requests.

```javascript
const options = { method: 'GET', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' } }; fetch('https://payments.zoho.com/api/v1/payments/731000001449003?account_id=23137556', options)
    .then(response => response.json())
    .then(response => console.log(response))
    .catch(err => console.error(err));
```

--------------------------------

### Ruby - Net::HTTP Request

Source: https://www.zoho.com/us/payments/api/v1/payments

Example of making a GET request using Ruby's Net::HTTP library. This is a standard library for HTTP requests.

```ruby
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://payments.zoho.com/api/v1/payments/731000001449003?account_id=23137556")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

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

--------------------------------

### Node.js - Request Module

Source: https://www.zoho.com/us/payments/api/v1/payments

Example of making a GET request using the 'request' module in Node.js. Note: The 'request' module is deprecated, consider using alternatives.

```javascript
const request = require('request');
const options = {
    method: 'GET',
    url: 'https://payments.zoho.com/api/v1/payments/731000001449003',
    qs: {account_id: '23137556'},
    headers: {
        Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
    }
};

request(options, function (error, response, body) {
    if (error) throw new Error(error);

    console.log(body);
});
```

--------------------------------

### Get Customer by Account ID (PHP HttpRequest)

Source: https://www.zoho.com/us/payments/api/v1/customers

This PHP example uses the HttpRequest class to fetch customer details. The account ID is passed as a query parameter.

```php
<?php
$request = new HttpRequest();
$request->setUrl('https://payments.zoho.com/api/v1/customers/173000002315107');
$request->setMethod(HTTP_METH_GET);
$request->setQueryData([
  'account_id' => '23137556'
]);
$request->setHeaders([
  'Authorization' => 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
]);

try {
  $response = $request->send();
  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}
```

--------------------------------

### Create Payment Session with PHP HTTP Client

Source: https://www.zoho.com/us/payments/api/v1/payment-session

This PHP example uses the http\Client and http\Client\Request classes to create a payment session. It demonstrates setting up the request body, URL, method, query parameters, and headers.

```php
<?php $client = new http\Client;
$request = new http\Client\Request;
$body = new http\Message\Body;
$body->append('{"field1":"value1","field2":"value2"}');
$request->setRequestUrl('https://payments.zoho.com/api/v1/paymentsessions');
$request->setRequestMethod('POST');
$request->setBody($body);
$request->setQuery(new http\QueryString([
    'account_id' => '23137556'
]));
$request->setHeaders([
    'Authorization' => 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
    'content-type' => 'application/json'
]);

$client->enqueue($request)->send();
$response = $client->getResponse();

echo $response->getBody();
```

--------------------------------

### Get Customer by Account ID (Node.js Unirest)

Source: https://www.zoho.com/us/payments/api/v1/customers

This Node.js example uses the Unirest library to query customer data. The account ID is passed as a query parameter.

```javascript
const unirest = require("unirest");
const req = unirest("GET", "https://payments.zoho.com/api/v1/customers/173000002315107");

req.query({
  "account_id": "23137556"
});

req.headers({
  "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
});

req.end(function (res) {
  if (res.error) throw new Error(res.error);

  console.log(res.body);
});
```
Tokens:
Raw