Cookbooks and recipes home

Use these quick tutorials to integrate Payabli workflows fast
View as MarkdownOpen in Claude
Applies to:DevelopersPartnersPaypoints

This page contains recipes that are designed to help you use and integrate Payabli. Recipes are short tutorials that cover a workflow. We’ve organized these by Payabli product area.

Browse by product

General recipes

Recipe: Authentication guide

/// Step 1: Get your API token

Navigate to PartnerHub > Developers > API Tokens and create a new organization token. Your API tokens carry privileges, so keep them secure!

Your token will look something like this: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

/// Step 2: Add token to request headers

Send the API token in the request header with the key requestToken. All API requests must be made over HTTPS.

$curl -X POST "https://api.payabli.com/api/ExampleEndpoint/authorize" \
> -H "Content-Type: application/json" \
> -H "requestToken: YOUR_API_TOKEN"

/// Step 3: Add idempotency key (recommended)

Include a unique idempotencyKey header to prevent duplicate transactions. This key persists for 2 minutes.

$curl -X POST "https://api.payabli.com/api/ExampleEndpoint/authorize" \
> -H "Content-Type: application/json" \
> -H "requestToken: YOUR_API_TOKEN" \
> -H "idempotencyKey: unique-request-id-123"

Learn more about authentication, API tokens, and idempotency in API overview.