Prerequisites
Before you start integrating Titus, you need to sign up, get your API keys, and register a webhook.
1. Sign for TitusCopied!
Sign up depending on your type of integration:
-
Platform: your site functions as a marketplace with payments going to directly submerchants/vendors:
-
Staging: https://gotitus.dev/platform/start
-
Production: https://gotitus.com/platform/start
-
-
Business: you are company that sells services/goods and receives payments directly:
-
Production: https://gotitus.com/business/onboarding
Use code 1234 for the phone login verification code on staging
For more on working in our staging environment see here.
2. Get your API keysCopied!
Once you complete sign up and are inside your dashboard, click into “Settings” and then “Keys” to find your Secret API Key.
Titus uses API keys to authenticate requests. For more on the request format, see Working with the API.
3. Register a webhookCopied!
Finally, in the dashboard, register a webhook endpoint for Titus to send events by navigating to “Settings” and then “Webhooks.”
The webhook endpoint should be a POST endpoint to which Titus will send requests with update-related payloads. You will use the provided webhook secret to verify the authenticity of webhook events.
For more details and implementation notes about webhooks, see:
WebhooksFor local development, you may need to open a public tunnel for Titus to access your webhook endpoint. A popular tool for tunnels is ngrok which creates a public forward url to forward requests to a configured local host. Register the generated forwarding url in the Titus dashboard, making sure to include the full path of your local endpoint.
Now, you are ready to complete your integration with Titus!