Skip to content
ecommerce docs

Development Quick Start Guide

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

1: Get your API credentials

Section titled “1: Get your API credentials”

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

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

Section titled “2: Set up your environment”

Dependencies

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

Example .env file

Section titled “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

Section titled “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

Section titled “4: Next steps”
Read about our API endpoints
See an example implementation