e-Próspera

Catalyst Program

e-Próspera's referral system: attribute residency and entity signups to your referral code and track referrals via the API.

View as Markdown

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).

On this page