# AIKloop Payments API

> AIKloop Payments (a fictional sandbox API used for a documentation demo) lets developers accept card payments, issue refunds and receive webhook events. The current version is v3. Versions v1 and v2 are deprecated: don't use /v1 or /v2 endpoints, query-string API keys, decimal amounts, a default currency, page/per_page pagination, or the X-AIKloop-Signature header with HMAC-SHA1. The Changelog has the full old-versus-new table.

Base URL: https://api.aikloop.example/v3

## Docs

- [Getting started](https://asergaz.github.io/aikloop-demo/after/getting-started/index.md): Authenticate with a Bearer token and make your first v3 payment
- [Accept a payment](https://asergaz.github.io/aikloop-demo/after/accept-a-payment/index.md): Create a payment with amounts in minor units, a required currency and an idempotency key
- [Refund a payment](https://asergaz.github.io/aikloop-demo/after/refunds/index.md): Refund all or part of a payment with POST /v3/refunds
- [List payments](https://asergaz.github.io/aikloop-demo/after/list-payments/index.md): Cursor pagination with limit and starting_after
- [Handle webhooks](https://asergaz.github.io/aikloop-demo/after/webhooks/index.md): Verify the AIKloop-Signature header with HMAC-SHA256 and a timestamp
- [Changelog](https://asergaz.github.io/aikloop-demo/after/changelog/index.md): What changed in each release, with an old-versus-new table for v3

## API reference

- [Payments](https://asergaz.github.io/aikloop-demo/after/reference/payments/index.md): Generated reference for the payments endpoints
- [Refunds](https://asergaz.github.io/aikloop-demo/after/reference/refunds/index.md): Generated reference for the refunds endpoints
- [Webhooks](https://asergaz.github.io/aikloop-demo/after/reference/webhooks/index.md): Generated reference for the webhooks endpoints

## Optional

- [OpenAPI spec](https://asergaz.github.io/aikloop-demo/after/openapi.json): the full machine-readable spec, OpenAPI 3.1, for tools and code generation