FAQ

📖Questions & Answers

Have a question about using the API? This section covers the most common issues, tips, and answers to help you integrate faster and avoid common pitfalls. If you don’t find what you’re looking for here, reach out to our support team.

Which OAuth grant type is supported?

client_credentials only. Include grant_type=client_credentials in the form data.

Where do I obtain client_id and client_secret?

Generate them in the Partner Dashboard under API Keys.

How long is an access_token valid?

Exactly the value of expires_in returned by the token call—currently 3600 seconds (60 minutes).

What is the minimal body for POST /payment/request?

{
  "amount": "100",
  "currency": "USD",
  "redirect_url": "https://yourapp.com/thanks"
}

Can I tag requests for internal tracking?

Yes, pass a reference_id string. It is returned unchanged in all responses.

What is the API rate limit?

The API enforces a rate limit of 5 requests per second per API key.

If you exceed this limit, you will receive an HTTP 429 “Too Many Requests” response. To avoid hitting the rate limit:

• Space out your requests evenly

• Implement exponential backoff and retry logic when you receive a 429 error

• Monitor your request volume to stay within limits

If your use case requires a higher rate limit, please contact our support team to discuss your integration needs.

How do I confirm payment completion?

Poll GET /payment/request/{id} until status equals paid.

What statuses can a payment request have?

pending, paid, expired, or cancelled.

What happens if required fields are missing?

The API returns 400 Bad Request with details in the error.message field.

Does the API support recurring or partial payments?

No. Each Payment Request is a one‑off charge for a fixed amount.

---