Development Quick Start Guide

This page presents the essential steps required to interact with the API.

1: Get your API credentials

You’ll need the following credentials to authenticate your requests:

• IWOCAPAY_SUPPLIER_ACCESS_TOKEN
• IWOCAPAY_SUPPLIER_UUID
• IWOCAPAY_API_URL (see Technical overview > Base URLs)

These credentials should be securely stored. For example, in a .env file.

You can request these details from your Account Manager. See Contact us.

2: Set up your environment

Dependencies

• Ensure your development environment supports making HTTP requests (for example, fetch in JavaScript, Guzzle in PHP, or requests in Python).

Example .env file

IWOCAPAY_API_URL=https://stage.iwoca-dev.co.uk/api/lending/edge/
IWOCAPAY_SUPPLIER_ACCESS_TOKEN=your-access-token
IWOCAPAY_SUPPLIER_UUID=your-supplier-uuid

3: Best practices

• Secure your API keys: Do not expose your API credentials in client-side code.
• Handle webhooks properly: Verify webhook payloads and ensure they originate from iwocaPay.
• Implement error handling: Handle unexpected responses or API errors gracefully.

4: Next steps

Read about our API endpoints

See an example implementation