Getting Started

Before You Begin

Before starting integration, ensure you understand the following key considerations:

• Partner Account Required - You need an active Raba7ni partner account
• Developer Tier - Choose between Sandbox (free, test mode) or Production tiers
• API Keys - You'll generate keys with specific scopes for security
• Product Selection - Choose the right API product for your use case

Integration Steps

1

Create Your Application

Log in to your partner dashboard and navigate to the Developer section. Create a new application and select your API product type.

Environment	Dashboard URL
Sandbox (testing)	https://app.raba7ni.com/en-us/partner/developer
Production	https://app.raba7ni.com/en-us/partner/developer

2

Generate API Keys

Create API keys with the appropriate scopes for your integration. Choose only the permissions your application needs for better security.

Security Best Practice

Only request scopes that your application actually needs. This limits potential damage if a key is compromised.

3

Make Your First Request

Use your App ID and API Key to authenticate and start making requests to our endpoints.

bash - Points API Example

curl -X POST "https://app.raba7ni.com/api/v1/loyalty/members/validate" \
  -H "X-App-Id: app_your_app_id" \
  -H "X-Api-Key: prod_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"card_id": 5, "phone_number": "+21612345678"}'

4

Handle the Response

All API responses follow a consistent JSON format. Check the success field to determine if the request was successful.

Success Response

{
  "success": true,
  "data": {
        "is_member": true,
    "validated_at": "2025-01-15T10:30:00Z"
      },
  "meta": {
    "mode": "test",
    "request_id": "req_abc123"
  }
}

Next Steps

Now that you've made your first request, explore these topics to deepen your integration: