PIK Open API reference overview

Overview of the PIK Open API: base URL, authentication, request and response format, pagination parameters, and error codes for every endpoint.

The PIK Open API gives you programmatic access to your PIK account. Use it to create payment links, query transaction history, manage webhook endpoints, and automate reconciliation workflows. All endpoints follow a consistent request/response format.

Base URL

https://api.pik.global/v1

All requests must be made over HTTPS. HTTP requests are rejected.

Authentication

Every request requires an API key passed as a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

See Authentication for details on generating and managing API keys.

Request format

Send request bodies as JSON with the Content-Type: application/json header:

curl -X POST https://api.pik.global/v1/payment-links \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "amount": "100.00", "currency": "USDT" }'

Response format

All responses are JSON. Successful responses return a 2xx status code. Error responses return a 4xx or 5xx status code with an error object:

{
  "error": {
    "code": "invalid_request",
    "message": "The 'amount' field is required."
  }
}

Pagination

List endpoints support pagination via limit and offset query parameters:

Parameter	Default	Max	Description
limit	20	100	Number of results per page
offset	0	—	Number of results to skip

Paginated responses include top-level total, limit, and offset fields.

Error codes

HTTP Status	Error Code	Meaning
400	invalid_request	Missing or invalid request parameter
401	unauthorized	Missing or invalid API key
403	forbidden	API key lacks permission for this action
404	not_found	The requested resource does not exist
422	unprocessable_entity	Valid request but business rule violation
429	rate_limited	Too many requests — slow down
500	internal_error	PIK server error — try again later

Rate limits

The PIK API enforces rate limits to ensure stability. If you exceed the limit, you receive a 429 response. Implement exponential backoff when retrying after a rate limit error.

Endpoints

Authentication

API key management reference

Payment Links

Create and retrieve payment links

Transactions

Query payment transactions

Webhooks

Register and manage webhook endpoints