Goal
By the end of this guide, you will have your API key and Partner ID for both test and production environments, and you will know how to reach Debitura support.
Before you start: gather internal information
Before contacting Debitura, collect the following information internally:
Company name and website
Description of your platform and client base (what does your product do, who are your customers)
Estimated monthly case volume (how many collection cases you expect to submit)
Target countries or jurisdictions (where your clients have debtors)
Technical contact (name and email of the person leading API integration)
Steps
Step 1: Apply for the referral partner program
Email [email protected] with the information listed above. The partnerships team will respond to discuss the program and confirm your eligibility.
Step 2: Review and sign the partnership agreement
After initial discussions, you will receive a referral partnership agreement. Review the terms, negotiate if needed, and sign the contract. Once the agreement is signed, Debitura provisions your partner account and issues API keys for the test environment.
Step 3: Receive your test environment credentials
After signing, you will receive:
API key (use in the X-Api-Key header for all API requests; see Developer Docs for full authentication details)
Partner ID (your unique identifier in Debitura's system)
Test environment access
The test environment uses these base URLs:
Referral Partner API: https://testreferral-api.debitura.com/
Customer API: https://testcustomer-api.debitura.com/
Onboarding app: https://testreferral.debitura.com/
Swagger documentation is available at /swagger on both API endpoints.
Step 4: Complete integration in the test environment
Work with your technical team to integrate the APIs. Typical integration takes 2 to 4 weeks and covers client creation, bearer token generation, and case submission. Contact [email protected] for technical support during this phase.
Before requesting production credentials, verify your integration against the test environment. See API & integration overview for technical details.
Step 5: Request production credentials
When your integration is tested and ready, email [email protected] to request production API keys. You will receive:
Production API key
Production Partner ID (same as test in most cases)
The production environment uses these base URLs:
Referral Partner API: https://referral-api.debitura.com/
Customer API: https://customer-api.debitura.com/
Onboarding app: https://referral.debitura.com/
Step 6: Set up support escalation paths
Ensure your team knows how to reach Debitura support:
Channel | Contact | Use for |
Technical support | API questions, integration issues, error troubleshooting | |
Partnerships team | Commercial terms, revenue questions, contract matters | |
Account Manager | Assigned after launch | Ongoing optimization, feature requests, strategic discussions |
Response time for technical support is within 24 hours on business days. Include your API request/response details, error messages, and timestamps when reporting issues.
Result
You now have API credentials for both test and production environments and know how to contact Debitura for support. Your team can proceed with the technical integration.
Next steps
Getting started with Debitura for the complete onboarding overview
API & integration overview for technical integration guidance
Standard Debt Collection Agreement to understand the contract your clients will sign
Developer Docs: Developers implementing the API can find detailed technical specifications in the Developer Docs