Catalyst Program
e-Próspera's referral system: attribute residency and entity signups to your referral code and track referrals via the API.
The Catalyst Program is e-Próspera's referral system. As a member, your referral code supports:
- Attribution for referred natural persons and legal entities
- 20% discount on the first eligible paid natural-person residency application (applied automatically at checkout)
Referral codes can be owned by natural persons or legal entities.
Residency discount
When a user attributed to your code reaches the payment step for an eligible residency application, the discount is applied automatically — no voucher needed.
- Applies to the first paid natural-person residency application only
- Does not apply to free residency options, renewals, entity applications, or other services
- Does not stack with other invoice discounts
Attributing entity incorporations
Pass your referralCode when creating a legal-entity application to attribute it as a referral. If omitted, the application proceeds without attribution.
curl -X POST https://portal.eprospera.com/api/v1/legal_entity_applications \
-H "Authorization: Bearer <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"applicationData": {
"residencyType": "e-Resident",
"entityType": "llc",
"name": "New Company",
"extension": "LLC",
"principalOffice": {
"line1": "123 Main Street",
"city": "Roatan",
"postalCode": "34101",
"country": "Honduras"
},
"contactEmail": "contact@example.com",
"registeredAgentProvider": "prospera_employment_solutions",
"registeredAgentDetails": null
},
"referralCode": "MYCODE123"
}'See the full POST legal_entity_applications reference for all available fields.
Self-referral
By default, using your own referral code silently skips attribution — the application succeeds, but isn't counted as a referral. If your code has self-referral enabled (configured by an admin), attribution is recorded. This is useful for companies that incorporate entities on behalf of clients using a single API key.
Checking referrals
List natural persons and legal entities referred with your code:
curl -X GET https://portal.eprospera.com/api/v1/referral-codes/MYCODE123/referrals \
-H "Authorization: Bearer <your-api-key>"{
"code": "MYCODE123",
"naturalPersons": [
{
"fullName": "John Doe",
"referredAt": "2024-03-15T14:30:00.000Z"
}
],
"legalEntities": [
{
"name": "Acme Corp LLC",
"rpn": "80123456789012",
"referredAt": "2024-04-01T12:00:00.000Z"
}
]
}See the full GET referral_codes/[code]/referrals reference. This endpoint reports attribution only — it does not expose invoice or discount state.
Access control
You can only query referral codes that belong to you (your personal code, or codes owned by entities you represent).
Testing in staging
The staging environment is a full copy of the e-Próspera portal where you can test your integration for free. All API endpoints, OAuth flows, and payment steps work identically to production.
Verify residents and entities as a compliance vendor
Confirm Resident Permit Numbers and look up registry records in real time for KYC, AML, and background-check workflows.