Starling Business API Integration (Bulk Payments)

We run a web application that prepares bulk payments (multiple recipients, amounts, references).
That part is already built.

We need a developer to integrate Starling Business Bank’s native API so users with a Starling Business account can execute those payments directly from their own bank account.

This is:
• ✔ Bank-native API integration
• ❌ Not Open Banking
• ❌ Not file uploads
• ❌ Not handling client money

⸻

What needs to be built

1) Connect Starling Business Account
• Add a “Connect Starling Business Account” button.
• Implement Starling OAuth 2.0 authorisation.
• Store access/refresh tokens, account UID and category UID securely.
• Allow users to disconnect/revoke access.

⸻

2) Execute Bulk Payments

When a user approves a payment run in our system:
• Use the Starling Business Payments API to create payments.
• One API call per payment (looped execution).
• Typical runs are 10–50 payments.
• Capture and store the paymentUid for each payment.
• Implement idempotency to prevent duplicates.

⸻

3) Payment Status Updates
• Implement Starling webhooks for payment events.
• Update each payment as paid / failed automatically.
• Record failure reasons where available.
• Write events to our existing activity log.

⸻

4) Error Handling
• Handle token expiry/revocation.
• Handle insufficient funds and invalid bank details.
• Allow retry of failed payments.
• Clean fallback to manual payment if needed.

⸻

What already exists
• Bulk payment preparation
• Approval workflows
• Manual payment fallback
• Payment status models
• Activity logs & notifications

You are only implementing the Starling integration layer.

⸻

Deliverables
• Starling OAuth connection flow
• Payment initiation logic
• Webhook handling
• Token management
• Short technical documentation

⸻

Skills required
• REST APIs
• OAuth 2.0
• Webhooks
• Payments / fintech integrations

⸻

Important
• This is not Open Banking
• No CSV/file uploads
• No client money handling

⸻

To apply

Please confirm:
• Experience with bank or payment APIs
• Familiarity with OAuth + webhooks
• Estimated time and cost