Code Examples

curl -X POST https://api.kyrenpay.com/v1/products \
  -H "Content-Type: application/json" \
  -H "x-api-key: kyren_live_xxxxxxxxxxxx" \
  -d '{
    "name": "1000 AI Credits",
    "description": "Top up 1000 credits for AI API usage",
    "price": "9.99",
    "currency": "USD",
    "metadata": {
      "credits": "1000"
    }
  }'

import requests

response = requests.post(
    "https://api.kyrenpay.com/v1/products",
    headers={
        "Content-Type": "application/json",
        "x-api-key": "kyren_live_xxxxxxxxxxxx",
    },
    json={
        "name": "1000 AI Credits",
        "description": "Top up 1000 credits for AI API usage",
        "price": "9.99",
        "currency": "USD",
        "metadata": {"credits": "1000"},
    },
)

product = response.json()["data"]
print(f"Product created: {product['id']}")

const axios = require('axios');

const response = await axios.post('https://api.kyrenpay.com/v1/products', {
  name: '1000 AI Credits',
  description: 'Top up 1000 credits for AI API usage',
  price: '9.99',
  currency: 'USD',
  metadata: { credits: '1000' },
}, {
  headers: { 'x-api-key': 'kyren_live_xxxxxxxxxxxx' },
});

const product = response.data.data;
console.log(`Product created: ${product.id}`);

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "io"
)

func createProduct() {
    payload := map[string]interface{}{
        "name":        "1000 AI Credits",
        "description": "Top up 1000 credits for AI API usage",
        "price":       "9.99",
        "currency":    "USD",
        "metadata":    map[string]string{"credits": "1000"},
    }

    body, _ := json.Marshal(payload)
    req, _ := http.NewRequest("POST", "https://api.kyrenpay.com/v1/products", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("x-api-key", "kyren_live_xxxxxxxxxxxx")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    respBody, _ := io.ReadAll(resp.Body)
    fmt.Println(string(respBody))
}

curl -X POST https://api.kyrenpay.com/v1/checkouts \
  -H "Content-Type: application/json" \
  -H "x-api-key: kyren_live_xxxxxxxxxxxx" \
  -d '{
    "productId": "prod_abc123",
    "successUrl": "https://yoursite.com/success",
    "cancelUrl": "https://yoursite.com/cancel",
    "customerEmail": "customer@example.com",
    "displayMerchantName": "Campaign Store",
    "metadata": {
      "userId": "user_456"
    }
  }'

import requests

response = requests.post(
    "https://api.kyrenpay.com/v1/checkouts",
    headers={
        "Content-Type": "application/json",
        "x-api-key": "kyren_live_xxxxxxxxxxxx",
    },
    json={
        "productId": "prod_abc123",
        "successUrl": "https://yoursite.com/success",
        "cancelUrl": "https://yoursite.com/cancel",
        "customerEmail": "customer@example.com",
        "displayMerchantName": "Campaign Store",
        "metadata": {"userId": "user_456"},
    },
)

checkout = response.json()["data"]
print(f"Redirect customer to: {checkout['url']}")

const response = await axios.post('https://api.kyrenpay.com/v1/checkouts', {
  productId: 'prod_abc123',
  successUrl: 'https://yoursite.com/success',
  cancelUrl: 'https://yoursite.com/cancel',
  customerEmail: 'customer@example.com',
  displayMerchantName: 'Campaign Store',
  metadata: { userId: 'user_456' },
}, {
  headers: { 'x-api-key': 'kyren_live_xxxxxxxxxxxx' },
});

const checkout = response.data.data;
console.log(`Redirect customer to: ${checkout.url}`);

func createCheckout() {
    payload := map[string]interface{}{
        "productId":     "prod_abc123",
        "successUrl":    "https://yoursite.com/success",
        "cancelUrl":     "https://yoursite.com/cancel",
        "customerEmail": "customer@example.com",
        "displayMerchantName": "Campaign Store",
        "metadata":      map[string]string{"userId": "user_456"},
    }

    body, _ := json.Marshal(payload)
    req, _ := http.NewRequest("POST", "https://api.kyrenpay.com/v1/checkouts", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("x-api-key", "kyren_live_xxxxxxxxxxxx")

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

    respBody, _ := io.ReadAll(resp.Body)
    fmt.Println(string(respBody))
}

curl https://api.kyrenpay.com/v1/orders?status=PAID&page=1&size=10 \
  -H "x-api-key: kyren_live_xxxxxxxxxxxx"

response = requests.get(
    "https://api.kyrenpay.com/v1/orders",
    headers={"x-api-key": "kyren_live_xxxxxxxxxxxx"},
    params={"status": "PAID", "page": 1, "size": 10},
)

data = response.json()["data"]
for order in data["items"]:
    print(f"Order {order['id']}: {order['amount']} {order['currency']}")

print(f"Total: {data['pagination']['total']} orders")

const response = await axios.get('https://api.kyrenpay.com/v1/orders', {
  headers: { 'x-api-key': 'kyren_live_xxxxxxxxxxxx' },
  params: { status: 'PAID', page: 1, size: 10 },
});

const { items, pagination } = response.data.data;
items.forEach(order => {
  console.log(`Order ${order.id}: ${order.amount} ${order.currency}`);
});
console.log(`Total: ${pagination.total} orders`);

func listOrders() {
    req, _ := http.NewRequest("GET", "https://api.kyrenpay.com/v1/orders?status=PAID&page=1&size=10", nil)
    req.Header.Set("x-api-key", "kyren_live_xxxxxxxxxxxx")

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

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

curl https://api.kyrenpay.com/v1/balance \
  -H "x-api-key: kyren_live_xxxxxxxxxxxx"

response = requests.get(
    "https://api.kyrenpay.com/v1/balance",
    headers={"x-api-key": "kyren_live_xxxxxxxxxxxx"},
)

balance = response.json()["data"]
print(f"Available: {balance['available']} {balance['currency']}")
print(f"Pending: {balance['pending']} {balance['currency']}")

const response = await axios.get('https://api.kyrenpay.com/v1/balance', {
  headers: { 'x-api-key': 'kyren_live_xxxxxxxxxxxx' },
});

const balance = response.data.data;
console.log(`Available: ${balance.available} ${balance.currency}`);
console.log(`Pending: ${balance.pending} ${balance.currency}`);

func getBalance() {
    req, _ := http.NewRequest("GET", "https://api.kyrenpay.com/v1/balance", nil)
    req.Header.Set("x-api-key", "kyren_live_xxxxxxxxxxxx")

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

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}