FAQ | API PayStar

Welcome to the PayStar.uk FAQ section. Here you’ll find answers to the most common questions from our partners and developers regarding integration and usage of the platform. We’ve covered key topics such as API authorization, transaction processing, callback setup, token management, custom checkout design, and more.

If you don’t find the answer you’re looking for, feel free to contact our technical support or use the built-in GPT assistant — it’s trained on our documentation and available 24/7 to help you.

Authorization

1. How can I obtain API authorization keys?

2. What is the TTL (time-to-live) of API authorization keys?

3. What is the base URL for API requests?

4. What headers are required for authorization in PayStar.uk?

5. What is a Bearer token and how long is it valid?

6. Where should I include the Bearer token in API requests?

7. Do I need to generate a Bearer token for every request?

8. Can I use the same Bearer token for all API methods?

9. Is there a rate limit for payment requests?

10. What should I do if my token no longer works?

11. What should I do if my token is valid but the payment doesn't go through?

12. Why do deposits work, but payouts return a 401 Unauthorized error?

13. Everything worked in the test environment, but now I’m getting a 403. Why?

14. How can I replace my key if it has been compromised?

15. Should the token be generated using keys and renewed every hour?

16. Can one token be used for cross-currency payments?

17. Is the mode (sandbox vs production) determined by the token?

Sandbox

18. Can I get access to the test environment?

19. How can I check if my keys are in `Test` or `Production` mode?

20. Can I test callbacks in sandbox mode?

21. Do I need to top up my balance to test payouts in production mode?

22. Will there be a separate set of keys for payouts and payments in production?

Callbacks

23. Is it enough to send the callback URL in the request to receive webhooks?

24. Are webhook retries supported if our server was temporarily down?

25. What types of payment callbacks can be configured?

26. Can I resend a callback for a payment?

27. Callbacks worked during integration, but not in production. Why?

Payments (Deposits & Payouts)

28. Can I make a payout with a zero balance?

29. What is the minimum and maximum payment amount?

30. When can a payment be considered failed?

31.Why is the payment taking too long to finalize?

32. What limits are applied to the keys and how can I check them?

Additional fields

33. What values are required in additionalFields?

34. Is there a list of accepted keys in additionalFields, or is it a freeform field?

35. How does the system handle unknown or unexpected fields in additionalFields?

36. Are additionalFields used in reports?

37. Are there any sensitive data that should not be sent via additionalFields?

38. Does additionalFields affect transaction processing, or is it just for logging/tracing?

39. Can nested objects or arrays be used in additionalFields, or is it flat only?

PayForm

40 How can I customize the design of the payment form?

Tech FAQ

Authorization#

Sandbox#

Callbacks#

Payments (Deposits & Payouts)#