Contact Us

Overview

The Contact API provides functionality for submitting contact form messages to the eFICA system. This allows users to send inquiries, support requests, and general messages through a structured contact form.

Base URL

https://sandboxapi.efica.co.za/contact

Authentication

All endpoints require Bearer token authentication. Include the token in the Authorization header:

Authorization: Bearer <your-jwt-token>

Core Endpoints

Submit Contact Form

Submit a contact form message to the eFICA system.

URL: POST /contact/contactEfica
Authentication: Required
Content-Type: application/json

Request Body

{
  "contactEficaType": "general",
  "contactSubject": "API Integration Question",
  "message": "I need help integrating the eFICA API into my application. Can you provide guidance on the authentication process?"
}

Request Body Parameters

Parameter	Type	Required	Description	Example
contactEficaType	string	Yes	Type of contact inquiry	"general"
contactSubject	string	Yes	Subject line of the message	"API Integration Question"
message	string	Yes	Main message content	"I need help with..."

Contact Types

The following contact types are supported:

Type	Description	Use Case
general	General inquiries	General questions about eFICA
support	Technical support	API integration issues
billing	Billing inquiries	Payment and subscription questions
compliance	Compliance questions	FICA compliance guidance
partnership	Partnership inquiries	Business partnership opportunities

Example Request

curl -X POST "https://sandboxapi.efica.co.za/contact/contactEfica" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contactEficaType": "support",
    "contactSubject": "API Authentication Issue",
    "message": "I am experiencing issues with JWT token authentication. The token expires after 1 hour and I need guidance on implementing token refresh logic."
  }'

Success Response (200 OK)

{
  "success": true,
  "message": "Contact form submitted successfully",
  "submissionID": "CONT-2023-001",
  "submittedAt": "2023-12-01T10:30:00.000Z"
}

Error Handling

HTTP Status Codes

Status Code	Description	Common Causes
200	Success	Contact form submitted successfully
400	Bad Request	Invalid input data or missing required fields
401	Unauthorized	Invalid or missing authentication token
403	Forbidden	Insufficient permissions for the requested operation
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Server-side error

Error Response Format

{
  "statusCode": 400,
  "message": "Validation failed",
  "error": "Bad Request",
  "details": [
    {
      "field": "contactSubject",
      "message": "Contact subject is required"
    },
    {
      "field": "message",
      "message": "Message content is required"
    }
  ]
}

Message Templates

Support Request Template

{
  "contactEficaType": "support",
  "contactSubject": "API Integration Issue - [Brief Description]",
  "message": "I am experiencing an issue with the eFICA API integration.\n\nIssue Description: [Detailed description]\n\nSteps to Reproduce:\n1. [Step 1]\n2. [Step 2]\n3. [Step 3]\n\nExpected Behavior: [What should happen]\nActual Behavior: [What actually happens]\n\nEnvironment:\n- API Version: [Version]\n- Programming Language: [Language]\n- Framework: [Framework]\n\nError Messages: [Any error messages]\n\nAdditional Context: [Any other relevant information]"
}

Billing Inquiry Template

{
  "contactEficaType": "billing",
  "contactSubject": "Billing Question - [Topic]",
  "message": "I have a question regarding my eFICA billing.\n\nQuestion: [Your specific question]\n\nAccount Information:\n- Company Name: [Your company]\n- Account ID: [If applicable]\n\nAdditional Details: [Any relevant context]\n\nPreferred Contact Method: [Email/Phone]\n\nThank you for your assistance."
}

General Inquiry Template

{
  "contactEficaType": "general",
  "contactSubject": "General Question - [Topic]",
  "message": "I have a general question about eFICA.\n\nQuestion: [Your question]\n\nContext: [Any relevant background information]\n\nHow can I help: [What specific assistance you need]\n\nThank you for your time."
}

Support

For technical support or questions about the Contact API:

1. Contact support at melissa@efica.co.za
2. Include relevant information:
   • API endpoint being called
   • Request data (without sensitive information)
   • Error response details
   • Steps to reproduce the issue

---

Last Updated: 19 August 2025