events

# Nothing to install: any HTTP client works.
export PAYRUDDER_API_KEY=qk_test_

curl -sS https://YOUR-API-ADDRESS/v1/events \
  -H "Authorization: Bearer $PAYRUDDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"events":[{"customer_external_id":"cus_42","meter_code":"api_calls","quantity":"1","event_time":"'"$(date -u +%Y-%m-%dT%H:%M:%SZ)"'","idempotency_key":"first-event-1"}]}'

# Not on npm yet: build the package from a checkout of the repository, then install the tarball it makes.
(cd /path/to/payrudder/sdk/typescript && npm ci && npm run build && npm pack)   # writes payrudder-sdk-0.0.0.tgz
npm install /path/to/payrudder/sdk/typescript/payrudder-sdk-0.0.0.tgz

import { Payrudder } from "@payrudder/sdk";

const payrudder = new Payrudder({ apiKey: process.env.PAYRUDDER_API_KEY, baseUrl: "https://YOUR-API-ADDRESS" }); // qk_test_...

await payrudder.customers.createCustomer({ external_id: "cus_42", name: "First customer", email: "first@example.com" });

const results = await payrudder.events.ingest([
  { customer_external_id: "cus_42", meter_code: "api_calls", quantity: "1", event_time: new Date(), idempotency_key: "first-event-1" },
]);
console.log(results[0].status); // accepted | duplicate | rejected

# Not on PyPI yet: install from a checkout of the repository.
pip install /path/to/payrudder/sdk/python

from datetime import datetime, timezone
from payrudder import Payrudder

client = Payrudder(api_key="qk_test_...", base_url="https://YOUR-API-ADDRESS")  # or PAYRUDDER_API_KEY / PAYRUDDER_BASE_URL

client.customers.create_customer({"external_id": "cus_42", "name": "First customer", "email": "first@example.com"})

results = client.events.ingest([
    {"customer_external_id": "cus_42", "meter_code": "api_calls", "quantity": "1",
     "event_time": datetime.now(timezone.utc).isoformat(), "idempotency_key": "first-event-1"},
])
print(results[0]["status"])  # accepted | duplicate | rejected

# Not on a module proxy yet: point your module at a checkout of the repository.
go mod edit -require=github.com/nafrucom/payrudder-sdks/go@v0.0.0
go mod edit -replace=github.com/nafrucom/payrudder-sdks/go=/path/to/payrudder/sdk/go

package main

import (
	"context"
	"fmt"
	"log"
	"time"

	payrudder "github.com/nafrucom/payrudder-sdks/go"
)

func main() {
	client, err := payrudder.New(payrudder.WithAPIKey("qk_test_..."), payrudder.WithBaseURL("https://YOUR-API-ADDRESS"))
	if err != nil {
		log.Fatal(err)
	}
	ctx := context.Background()
	if _, err := client.Customers.CreateCustomer(ctx, &payrudder.CreateCustomerRequest{ExternalID: "cus_42", Name: "First customer", Email: "first@example.com"}); err != nil {
		log.Fatal(err)
	}
	results, err := client.Events.Ingest(ctx, []payrudder.IncomingEvent{{
		CustomerExternalID: "cus_42", MeterCode: "api_calls", Quantity: "1", EventTime: time.Now(), IdempotencyKey: "first-event-1",
	}})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(results[0].Status)
}

# Not on Packagist yet: use a checkout of the repository as a path repository.
composer config repositories.payrudder path /path/to/payrudder/sdk/php
composer require payrudder/payrudder-php:"*@dev"

use Payrudder\Client;

$client = new Client(apiKey: 'qk_test_...', baseUrl: 'https://YOUR-API-ADDRESS');

$client->customers->createCustomer(['external_id' => 'cus_42', 'name' => 'First customer', 'email' => 'first@example.com']);

$result = $client->events->ingest([
    ['customer_external_id' => 'cus_42', 'meter_code' => 'api_calls', 'quantity' => '1', 'event_time' => gmdate('c'), 'idempotency_key' => 'first-event-1'],
]);
var_dump($result[0]->status);