API Documentation¶
An interactive Swagger UI is available at app.secpaid.com/swagger. It reflects the same V2 endpoints documented here and allows you to test requests directly from the browser.
Developer Access¶
Contact compute@spacepitch.org to request API keys for development or production. A demo key is available for immediate testing:
Development demo key: u06AuLfBhQdQDtYGVcbGQtUNgIO1wrFN
The demo key generates test payment links backed by the PSP sandbox environment. You can authorize or cancel demo payments to validate your webhook and callback integrations. It does not process real transactions.
How-To¶
See the How-To section for guides on setting up webhooks, callbacks, refunds, and split links to integrate SecPaid into your system.
Important Notes¶
-
Demo key limitations — the demo key does not create live payment links. Use it only for integration testing.
-
Recipient tokens — to use Split Links in the development environment, recipients can retrieve their token from their account settings. In production, contact support after the recipient has registered.
-
Best practices: - Always use HTTPS. - Store API keys in environment variables. - Implement retry logic with exponential backoff for transient failures. - Validate
ResponseCodeandResulton every response. -
Registration — a valid production API key requires a registered and verified SecPaid account.
-
Rate limiting — requests exceeding your per-key limit return
429 Too Many Requests. Contact support to increase limits for testing or high-volume use. -
Testing environment — always test against
https://app.dev.secpaid.combefore deploying to production.