Koywe

https://docs.koywe.com
Admin
Koywe provides powerful APIs for fast, easy, and secure Latin American financial operations,...
Tokens:3,125,358
Snippets:8,781
Trust Score:8.1
Update:9 months ago
Show doc for...
Tokens:
Raw
### Create and Manage Payments with Koywe API

Source: https://docs.koywe.com/payments/quickstart

This example demonstrates how to authenticate with the Koywe API, create a contact, generate a PAYIN order, and check its status. It requires environment variables for organization ID, merchant ID, API key, and secret. The output includes the payment URL for redirecting customers.

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

const BASE_URL = 'https://api-sandbox.koywe.com/api/v1';
const ORG_ID = process.env.KOYWE_ORG_ID;
const MERCHANT_ID = process.env.KOYWE_MERCHANT_ID;
const API_KEY = process.env.KOYWE_API_KEY;
const SECRET = process.env.KOYWE_SECRET;

async function main() {
  try {
    // 1. Authenticate
    console.log('1. Authenticating...');
    const authResponse = await axios.post(`${BASE_URL}/auth/sign-in`, {
      apiKey: API_KEY,
      secret: SECRET
    });
    const token = authResponse.data.token;
    console.log('✓ Authenticated');

    // 2. Create contact
    console.log('\n2. Creating contact...');
    const contactResponse = await axios.post(
      `${BASE_URL}/organizations/${ORG_ID}/merchants/${MERCHANT_ID}/contacts`,
      {
        email: 'customer@example.com',
        phone: '+573001234567',
        fullName: 'Juan Pérez',
        countrySymbol: 'CO',
        documentType: 'CC',
        documentNumber: '1234567890',
        businessType: 'PERSON'
      },
      { headers: { Authorization: `Bearer ${token}` } }
    );
    const contactId = contactResponse.data.id;
    console.log('✓ Contact created:', contactId);

    // 3. Create PAYIN order
    console.log('\n3. Creating payment order...');
    const orderResponse = await axios.post(
      `${BASE_URL}/organizations/${ORG_ID}/merchants/${MERCHANT_ID}/orders`,
      {
        type: 'PAYIN',
        originCurrencySymbol: 'COP',
        destinationCurrencySymbol: 'COP',
        amountIn: 50000,
        description: 'Payment for Order #12345',
        externalId: `order-${Date.now()}`,
        contactId: contactId,
        paymentMethods: [{ method: 'PSE', extra: 'BANCOLOMBIA' }],
        successUrl: 'https://yoursite.com/success',
        failedUrl: 'https://yoursite.com/failed'
      },
      { headers: { Authorization: `Bearer ${token}` } }
    );
    const order = orderResponse.data;
    console.log('✓ Order created:', order.id);
    console.log('✓ Payment URL:', order.paymentUrl);

    // 4. Check order status
    console.log('\n4. Checking order status...');
    const statusResponse = await axios.get(
      `${BASE_URL}/organizations/${ORG_ID}/merchants/${MERCHANT_ID}/orders/${order.id}`,
      { headers: { Authorization: `Bearer ${token}` } }
    );
    console.log('✓ Current status:', statusResponse.data.status);

    console.log('\n✅ Success! Payment order created.');
    console.log('👉 Redirect your customer to:', order.paymentUrl);

  } catch (error) {
    console.error('❌ Error:', error.response?.data || error.message);
  }
}

main();

```

```python
import requests
import os
import time

BASE_URL = 'https://api-sandbox.koywe.com/api/v1'
ORG_ID = os.environ['KOYWE_ORG_ID']
MERCHANT_ID = os.environ['KOYWE_MERCHANT_ID']
API_KEY = os.environ['KOYWE_API_KEY']
SECRET = os.environ['KOYWE_SECRET']

def main():
    try:
        # 1. Authenticate
        print('1. Authenticating...')
        auth_response = requests.post(
            f'{BASE_URL}/auth/sign-in',
            json={'apiKey': API_KEY, 'secret': SECRET}
        )
        auth_response.raise_for_status()
        token = auth_response.json()['token']
        print('✓ Authenticated')

        headers = {'Authorization': f'Bearer {token}', 'Content-Type': 'application/json'}

        # 2. Create contact
        print('\n2. Creating contact...')
        contact_response = requests.post(
            f'{BASE_URL}/organizations/{ORG_ID}/merchants/{MERCHANT_ID}/contacts',
            json={
                'email': 'customer@example.com',
                'phone': '+573001234567',
                'fullName': 'Juan Pérez',
                'countrySymbol': 'CO',
                'documentType': 'CC',
                'documentNumber': '1234567890',
                'businessType': 'PERSON'
            },
            headers=headers
        )
        contact_response.raise_for_status()
        contact_id = contact_response.json()['id']
        print(f'✓ Contact created: {contact_id}')

        # 3. Create PAYIN order
        print('\n3. Creating payment order...')
        order_response = requests.post(
            f'{BASE_URL}/organizations/{ORG_ID}/merchants/{MERCHANT_ID}/orders',
            json={
                'type': 'PAYIN',
                'originCurrencySymbol': 'COP',
                'destinationCurrencySymbol': 'COP',
                'amountIn': 50000,
                'description': 'Payment for Order #12345',
                'externalId': f'order-{int(time.time())}',
                'contactId': contact_id,
                'paymentMethods': [{'method': 'PSE', 'extra': 'BANCOLOMBIA'}],
                'successUrl': 'https://yoursite.com/success',
                'failedUrl': 'https://yoursite.com/failed'
            },
            headers=headers
        )
        order_response.raise_for_status()
        order = order_response.json()
        print(f'✓ Order created: {order["id"]}')
        print(f'✓ Payment URL: {order["paymentUrl"]}')

        # 4. Check order status
        print('\n4. Checking order status...')
        status_response = requests.get(
            f'{BASE_URL}/organizations/{ORG_ID}/merchants/{MERCHANT_ID}/orders/{order["id"]}',
            headers=headers
        )
        status_response.raise_for_status()
        print(f'✓ Current status: {status_response.json()["status"]}')

        print('\n✅ Success! Payment order created.')
        print(f'👉 Redirect your customer to: {order["paymentUrl"]}')

    except requests.exceptions.RequestException as e:
        print(f'❌ Error: {e}')

main()

```

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

### Get Currency-Token Pairs (PHP)

Source: https://docs.koywe.com/english/crypto/api-documentation/res-tful-api/crypto-api/currency/token-currecy-pair

Fetches currency-token pairs from the Koywe API using the Guzzle HTTP client. This PHP example demonstrates making a GET request and retrieving the response body. Requires the GuzzleHttp client package to be installed via Composer.

```php
<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-sandbox.koywe.com/rest/currency-tokens/currencySymbol');

echo $response->getBody();

```

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

### Create Account - Java SDK Example

Source: https://docs.koywe.com/billing/api-reference/billing-api/%F0%9F%8F%A2-accounts/create-a-new-account

Shows a Java example using Unirest to create a new account via the Koywe API. This snippet demonstrates setting headers and the JSON request body for the POST request.

```java
HttpResponse<String> response = Unirest.post("https://api-billing.koywe.com/V1/accounts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"country_id\": 1,\n  \"contact_name\": \"contact_name\",\n  \"contact_phone\": \"contact_phone\",\n  \"admin_email\": \"admin_email\",\n  \"admin_password\": \"admin_password\",\n  \"registration_legal_name_company\": \"registration_legal_name_company\",\n  \"registration_tax_id_code\": \"registration_tax_id_code\",\n  \"registration_tax_id_type\": \"registration_tax_id_type\",\n  \"registration_company_size\": \"registration_company_size\",\n  \"registration_terms_of_use\": 1,\n  \"registration_type_use\": 1\n}")
  .asString();
```

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

### Fetch Digital Certificates: Koywe API Examples

Source: https://docs.koywe.com/english/billing/api-reference/billing-api/%F0%9F%93%9C-digital-certificates/get-a-paginated-list-of-certificates

These examples demonstrate how to fetch digital certificates from the Koywe API. They require an authorization token and make a GET request to the '/V1/digital_certificates' endpoint. Ensure you have the necessary libraries installed for each language (e.g., requests for Python, fetch API for JavaScript, net/http for Go, etc.).

```python
import requests

url = "https://api-billing.koywe.com/V1/digital_certificates"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api-billing.koywe.com/V1/digital_certificates';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

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

func main() {

	url := "https://api-billing.koywe.com/V1/digital_certificates"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

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

}
```

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

url = URI("https://api-billing.koywe.com/V1/digital_certificates")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

```java
HttpResponse<String> response = Unirest.get("https://api-billing.koywe.com/V1/digital_certificates")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-billing.koywe.com/V1/digital_certificates', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

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

```csharp
var client = new RestClient("https://api-billing.koywe.com/V1/digital_certificates");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api-billing.koywe.com/V1/digital_certificates")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

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

### Retrieve Account Information via Koywe API

Source: https://docs.koywe.com/english/payments/payments-api-reference/payments-api/merchant/get-bank-account-by-id

Demonstrates how to fetch account details from the Koywe API using a GET request. This requires an API token for authorization. The examples show basic request setup and response handling in each language.

```python
import requests

url = "https://api-sandbox.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/accounts/accountId"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api-sandbox.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/accounts/accountId';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

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

func main() {

	url := "https://api-sandbox.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/accounts/accountId"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

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

}
```

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

url = URI("https://api-sandbox.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/accounts/accountId")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

```java
HttpResponse<String> response = Unirest.get("https://api-sandbox.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/accounts/accountId")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-sandbox.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/accounts/accountId', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();

```

```csharp
var client = new RestClient("https://api-sandbox.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/accounts/accountId");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api-sandbox.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/accounts/accountId")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

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

### Fetch Users with Pagination and Filtering (Go)

Source: https://docs.koywe.com/english/payments/payments-api-reference/payments-api/merchant/get-merchant-users

This Go example utilizes the standard 'net/http' package to perform a GET request to the Koywe API. It shows how to construct the URL with query parameters, set the Authorization header, and read the response body. Error handling for the request and response reading is omitted for brevity.

```go
package main

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

func main() {

	url := "https://api-sandbox.koywe.com/api/v1/organizations/org_abc123/merchants/mrc_def456/users?page=1&limit=10&name=John&email=john%40doe.com"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

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

}
```

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

### Create Account - JavaScript SDK Example

Source: https://docs.koywe.com/billing/api-reference/billing-api/%F0%9F%8F%A2-accounts/create-a-new-account

Shows how to create a new account using the Koywe API with JavaScript's fetch API. It makes a POST request with account details and an authorization token.

```javascript
const url = 'https://api-billing.koywe.com/V1/accounts';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"country_id":1,"contact_name":"contact_name","contact_phone":"contact_phone","admin_email":"admin_email","admin_password":"admin_password","registration_legal_name_company":"registration_legal_name_company","registration_tax_id_code":"registration_tax_id_code","registration_tax_id_type":"registration_tax_id_type","registration_company_size":"registration_company_size","registration_terms_of_use":1,"registration_type_use":1}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

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

### Fetch Order Reports - Python SDK Example

Source: https://docs.koywe.com/english/payments/payments-api-reference/payments-api/reports/get-orders-report

This Python code snippet demonstrates how to fetch order reports from the Koywe API. It utilizes the 'requests' library to make an authenticated GET request with specified date parameters. Ensure you have the 'requests' library installed.

```python
import requests

url = "https://api-sandbox.koywe.com/api/v1/organizations/org3_8821b7b4-7f0c-45d9-aa5f-a9ce41ee2f1e/merchants/mrc_2e8f96ab-dbd5-45f9-b4b6-645945daf340/accounts/acc_0031c537-2301-40ab-9153-0f7c48505350/reports/orders"

querystring = {"from":"2025-01-01","to":"2025-01-31"}

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

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

### Create a Contact (Python)

Source: https://docs.koywe.com/payments/quickstart

Create a new contact for your organization and merchant using Python. This function requires a valid authentication token and the organization/merchant IDs. It returns the details of the newly created contact.

```python
def create_contact(token, org_id, merchant_id):
    response = requests.post(
        f'https://api-sandbox.koywe.com/api/v1/organizations/{org_id}/merchants/{merchant_id}/contacts',
        json={
            'email': 'customer@example.com',
            'phone': '+573001234567',
            'fullName': 'Juan Pérez',
            'countrySymbol': 'CO',
            'documentType': 'CC',
            'documentNumber': '1234567890',
            'businessType': 'PERSON'
        },
        headers={
            'Authorization': f'Bearer {token}',
            'Content-Type': 'application/json'
        }
    )
    
    return response.json()

# Usage
contact = create_contact(token, 'your_org_id', 'your_merchant_id')
print(f"Contact ID: {contact['id']}")
```

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

### Fetch Order Reports - PHP SDK Example

Source: https://docs.koywe.com/english/payments/payments-api-reference/payments-api/reports/get-orders-report

This PHP code snippet utilizes the Guzzle HTTP client to fetch order reports from the Koywe API. It shows how to set the Authorization header for a GET request. Make sure the GuzzleHttp library is installed via Composer.

```php
<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-sandbox.koywe.com/api/v1/organizations/org3_8821b7b4-7f0c-45d9-aa5f-a9ce41ee2f1e/merchants/mrc_2e8f96ab-dbd5-45f9-b4b6-645945daf340/accounts/acc_0031c537-2301-40ab-9153-0f7c48505350/reports/orders?from=2025-01-01&to=2025-01-31', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

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

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

### Fetch Quote Details using PHP

Source: https://docs.koywe.com/english/crypto/api-documentation/res-tful-api/crypto-api/quote-queries/get-quote

Demonstrates fetching quote details via the Koywe API using the Guzzle HTTP client in PHP. This example initializes a Guzzle client, makes a GET request, and echoes the response body. Ensure Guzzle is installed via Composer (`composer require guzzlehttp/guzzle`).

```php
<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-sandbox.koywe.com/rest/quotes/quoteId');

echo $response->getBody();

```

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

### Fetch Products from Koywe API (Python, JavaScript, Go, Ruby, Java, PHP, C#, Swift)

Source: https://docs.koywe.com/english/billing/api-reference/billing-api/%F0%9F%93%A6-products/lists-all-products

These examples show how to retrieve a list of products from the Koywe API. They cover multiple programming languages and demonstrate basic HTTP GET requests.

```python
import requests

url = "https://api-billing.koywe.com/V1/products"

response = requests.get(url)

print(response.json())
```

```javascript
const url = 'https://api-billing.koywe.com/V1/products';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

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

func main() {

	url := "https://api-billing.koywe.com/V1/products"

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

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

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

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

}
```

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

url = URI("https://api-billing.koywe.com/V1/products")

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

request = Net::HTTP::Get.new(url)

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

```java
HttpResponse<String> response = Unirest.get("https://api-billing.koywe.com/V1/products")
  .asString();
```

```php
<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-billing.koywe.com/V1/products');

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

```csharp
var client = new RestClient("https://api-billing.koywe.com/V1/products");
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let request = NSMutableURLRequest(url: NSURL(string: "https://api-billing.koywe.com/V1/products")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

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

### Fetch Bank Data from Koywe API (PHP)

Source: https://docs.koywe.com/english/payments/payments-api-reference/payments-api/countries/get-available-banks

This PHP code example utilizes the Guzzle HTTP client to fetch bank data from the Koywe API. It sends a GET request and echoes the response body. Make sure the GuzzleHttp client is installed via Composer.

```php
<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-sandbox.koywe.com/api/v1/banks');

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

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

### Create Account - Go SDK Example

Source: https://docs.koywe.com/billing/api-reference/billing-api/%F0%9F%8F%A2-accounts/create-a-new-account

Provides a Go code snippet for creating a new account via the Koywe API. It utilizes the net/http package to send a POST request with necessary headers and a JSON payload.

```go
package main

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

func main() {

	url := "https://api-billing.koywe.com/V1/accounts"

	payload := strings.NewReader("{\n  \"country_id\": 1,\n  \"contact_name\": \"contact_name\",\n  \"contact_phone\": \"contact_phone\",\n  \"admin_email\": \"admin_email\",\n  \"admin_password\": \"admin_password\",\n  \"registration_legal_name_company\": \"registration_legal_name_company\",\n  \"registration_tax_id_code\": \"registration_tax_id_code\",\n  \"registration_tax_id_type\": \"registration_tax_id_type\",\n  \"registration_company_size\": \"registration_company_size\",\n  \"registration_terms_of_use\": 1,\n  \"registration_type_use\": 1\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(res)
	fmt.Println(string(body))

}
```

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

### Create Account - Python SDK Example

Source: https://docs.koywe.com/billing/api-reference/billing-api/%F0%9F%8F%A2-accounts/create-a-new-account

Demonstrates how to create a new account using the Koywe API with Python's requests library. It sends a POST request with account details and an authorization token.

```python
import requests

url = "https://api-billing.koywe.com/V1/accounts"

payload = {
    "country_id": 1,
    "contact_name": "contact_name",
    "contact_phone": "contact_phone",
    "admin_email": "admin_email",
    "admin_password": "admin_password",
    "registration_legal_name_company": "registration_legal_name_company",
    "registration_tax_id_code": "registration_tax_id_code",
    "registration_tax_id_type": "registration_tax_id_type",
    "registration_company_size": "registration_company_size",
    "registration_terms_of_use": 1,
    "registration_type_use": 1
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.json())
```

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

### Check Order Status with Koywe API (Node.js)

Source: https://docs.koywe.com/payments/guides/accepting-payments/integration

This Node.js function uses the `axios` library to make a GET request to the Koywe API to retrieve the status of a specific order. It requires authentication credentials and order details. The function returns the order data, which includes status, amount, currency, and dates. Ensure `axios` is installed (`npm install axios`).

```javascript
async function getOrderStatus(token, orgId, merchantId, orderId) {
      const response = await axios.get(
        `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders/${orderId}`,
        {
          headers: { 
            'Authorization': `Bearer ${token}`
          }
        }
      );
      
      return response.data;
    }

    // Usage
    const order = await getOrderStatus(token, orgId, merchantId, 'ord_abc123');
    console.log('Current status:', order.status);
    console.log('Amount:', order.amountIn, order.originCurrencySymbol);
```

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

### Fetch Order Details using Koywe API (PHP)

Source: https://docs.koywe.com/english/payments/payments-api-reference/payments-api/orders/get-order-by-id

This PHP example utilizes the GuzzleHttp client to send a GET request to the Koywe API for order information. It shows how to configure the request with the necessary Authorization header. The response body is then echoed. The GuzzleHttp library must be installed.

```php
<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-sandbox.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/orders/orderId', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

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

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

### POST /api/v1/auth/sign-in

Source: https://docs.koywe.com/english/payments/quickstart

Obtain an access token by authenticating with your API key and secret. This token is required for all subsequent authenticated requests.

```APIDOC
## POST /api/v1/auth/sign-in

### Description
Authenticates with the Koywe API using provided API key and secret to obtain an access token.

### Method
POST

### Endpoint
/api/v1/auth/sign-in

### Parameters
#### Request Body
- **apiKey** (string) - Required - Your Koywe API key.
- **secret** (string) - Required - Your Koywe API secret.

### Request Example
```json
{
  "apiKey": "your_api_key",
  "secret": "your_secret"
}
```

### Response
#### Success Response (200)
- **token** (string) - The obtained access token. This token is valid for 1 hour and must be included in the `Authorization: Bearer YOUR_TOKEN` header for subsequent requests.

#### Response Example
```json
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
```
```

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

### Create Koywe Account using Go SDK

Source: https://docs.koywe.com/crypto/api-documentation/res-tful-api/crypto-api/accounts/account

This Go code snippet demonstrates creating a new account with Koywe using the standard `net/http` package. It constructs a POST request with the necessary headers and JSON payload. This example is self-contained and does not require external libraries beyond the Go standard library.

```go
package main

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

func main() {

	url := "https://api-sandbox.koywe.com/rest/accounts"

	payload := strings.NewReader("{\n  \"document\": {\n    \"isCompany\": true,\n    \"documentNumber\": \"documentNumber\",\n    \"documentType\": \"RUT\",\n    \"country\": \"country\"\n  },\n  \"address\": {\n    \"addressCity\": \"addressCity\",\n    \"addressStreet\": \"addressStreet\",\n    \"addressZipCode\": \"addressZipCode\",\n    \"addressCountry\": \"addressCountry\",\n    \"addressState\": \"addressState\"\n  },\n  \"personalInfo\": {\n    \"names\": \"names\",\n    \"activity\": \"activity\",\n    \"dob\": \"dob\",\n    \"phoneNumber\": \"phoneNumber\"\n  }\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(res)
	fmt.Println(string(body))

}
```

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

### Fetch Bank Data from Koywe API (Ruby)

Source: https://docs.koywe.com/english/payments/payments-api-reference/payments-api/countries/get-available-banks

This Ruby example illustrates fetching bank data from the Koywe API using the `net/http` and `uri` libraries. It establishes an HTTPS connection, sends a GET request, and prints the response body. This code assumes a standard Ruby installation.

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

url = URI("https://api-sandbox.koywe.com/api/v1/banks")

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

request = Net::HTTP::Get.new(url)

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

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

### Create Merchant Account - Go

Source: https://docs.koywe.com/english/payments/payments-api-reference/payments-api/contact/create-account

This Go example illustrates how to create a merchant account by making an HTTP POST request to the Koywe API. It utilizes the 'net/http' package and constructs the request with appropriate headers and a JSON payload.

```go
package main

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

func main() {

	url := "https://api-sandbox.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/contacts/contactId/accounts"

	payload := strings.NewReader("{ \n  \"name\": \"Banking of the Corp\",\n  \"kind\": \"BANK\",\n  \"address\": \"0x123...\",\n  \"network\": \"ETHEREUM\",\n  \"accountNumber\": \"012342134-123\",\n  \"routingNumber\": \"123456789\",\n  \"isDefault\": true,\n  \"currencySymbol\": \"ARS\"\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(res)
	fmt.Println(string(body))

}
```

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

### Get Document Authorizations using Koywe API (Python, JavaScript, Go, Ruby, Java, PHP, C#, Swift)

Source: https://docs.koywe.com/english/billing/api-reference/billing-api/%F0%9F%93%91-document-authorizations/get-a-paginated-list-of-documents-authorizations

Examples of how to fetch document authorizations from the Koywe API using the GET method. Each snippet includes necessary imports, URL definition, authorization header setup, and response handling. Ensure you replace '<token>' with your actual API key.

```python
import requests

url = "https://api-billing.koywe.com/V1/document_authorizations"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api-billing.koywe.com/V1/document_authorizations';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

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

func main() {

	url := "https://api-billing.koywe.com/V1/document_authorizations"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

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

}
```

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

url = URI("https://api-billing.koywe.com/V1/document_authorizations")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

```java
HttpResponse<String> response = Unirest.get("https://api-billing.koywe.com/V1/document_authorizations")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-billing.koywe.com/V1/document_authorizations', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

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

```csharp
var client = new RestClient("https://api-billing.koywe.com/V1/document_authorizations");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api-billing.koywe.com/V1/document_authorizations")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

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

### Fetch Merchant Features with Koywe API (Python, JavaScript, Go, Ruby, Java, PHP, C#, Swift)

Source: https://docs.koywe.com/english/payments/payments-api-reference/payments-api/merchant/get-merchant-features

These examples demonstrate how to fetch merchant features from the Koywe API. They require an authorization token and make a GET request to a specific API endpoint. The response, typically in JSON format, is then processed or displayed. Ensure you have the necessary HTTP client libraries installed for each language.

```python
import requests

url = "https://api-sandbox.koywe.com/api/v1/organizations/org_abc123/merchants/mrc_def456/features"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api-sandbox.koywe.com/api/v1/organizations/org_abc123/merchants/mrc_def456/features';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

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

func main() {

	url := "https://api-sandbox.koywe.com/api/v1/organizations/org_abc123/merchants/mrc_def456/features"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

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

}
```

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

url = URI("https://api-sandbox.koywe.com/api/v1/organizations/org_abc123/merchants/mrc_def456/features")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

```java
HttpResponse<String> response = Unirest.get("https://api-sandbox.koywe.com/api/v1/organizations/org_abc123/merchants/mrc_def456/features")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-sandbox.koywe.com/api/v1/organizations/org_abc123/merchants/mrc_def456/features', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();

```

```csharp
var client = new RestClient("https://api-sandbox.koywe.com/api/v1/organizations/org_abc123/merchants/mrc_def456/features");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api-sandbox.koywe.com/api/v1/organizations/org_abc123/merchants/mrc_def456/features")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

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

### Authentication API

Source: https://docs.koywe.com/english/payments/quickstart

Handles the authentication process to obtain an API token.

```APIDOC
## POST /auth/sign-in

### Description
Authenticates the user using API key and secret to obtain an access token.

### Method
POST

### Endpoint
/auth/sign-in

### Parameters
#### Request Body
- **apiKey** (string) - Required - Your Koywe API key.
- **secret** (string) - Required - Your Koywe API secret.

### Request Example
```json
{
  "apiKey": "YOUR_API_KEY",
  "secret": "YOUR_API_SECRET"
}
```

### Response
#### Success Response (200)
- **token** (string) - The authentication token.

#### Response Example
```json
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
```
```
Tokens:
Raw