Quick Start

✨Step by step

Follow these steps and you will have a working payment link in minutes:

1

Generate an API Key

Log in to the Partner Dashboard and go to Team Preferences > API Keys. Create a new key to identify your integration.

API Key

2

Authenticate via OAuth 2.0

Use the API Key to obtain an access token using the client credentials grant type.

OAuth Authentication

3

Create a payment request

Use your access token to create a new payment request with the desired amount, currency, and redirect URL.

Create a payment request

4

Check payment status

Poll the API to retrieve the current status of the payment.

Retrieve a Payment Request

---

🧰 Environments & Base URLs

Environment	Base URL
Production (default)	https://public-api.alternativepayments.io
Demo	https://public-api.demo.alternativepayments.io

All examples in this guide use production URLs. Switch to the demo when you test. Tokens and requests are isolated per environment.

Caution

Tokens issued in one environment do NOT work in the other. Generate separate client credentials for demo and production.

API Versioning

The current stable version is v1. Backward‑compatible changes (new fields, new statuses) are rolled out without a version bump. Breaking changes, if ever needed, will ship under /v2.