BursaPay Logo
Knowledge Base
Ticket Sign In
Help Center > Developer Platform & Gateway API > Developer API Scopes and Least-Privilege Access

Developer API Scopes and Least-Privilege Access

Published 2026-08-23 6 min read
Who is this article for?
This guide is for Developers, Security Teams seeking operational guidance on BursaPay workflows.

UI Navigation Path (Step-by-Step)

  1. List the operations the integration needs.
  2. Map each operation to its required scope.
  3. Assign the smallest adequate scope set.
  4. Test an allowed request and an intentionally disallowed request.
Verified BursaPay gateway workflow: Explains the permission scopes available to DeveloperApiKey records.

1. Overview & Purpose

The implemented key scopes include payments:read, payments:write, transfers:write, webhooks:manage, customers:read, customers:write, invoices:read and invoices:write.

2. Requirements & Setup

Choose scopes that match the application task instead of granting unrelated write access.

3. Step-by-Step Workflow

  1. List the operations the integration needs.
  2. Map each operation to its required scope.
  3. Assign the smallest adequate scope set.
  4. Test an allowed request and an intentionally disallowed request.

4. Rules & Troubleshooting

Scope failures should be handled as authorization errors rather than retried indefinitely.

5. Verification & Next Steps

Review scopes when the integration changes.

Was this article useful?

Related Articles

Developer API Authentication Headers Developer API IP Allowlisting
Ask Bursa AI