Initialize a Developer Gateway Payment

1. Overview & Purpose

The published gateway API exposes POST /api/v1/payments/initialize/ and returns an internal payment reference plus an authorization URL.

2. Requirements & Setup

A valid secret key, customer email and amount are required.

3. Step-by-Step Workflow

1. Build the initialize-payment payload.
2. Send POST /api/v1/payments/initialize/.
3. Store the returned BursaPay reference.
4. Redirect the customer to the authorization URL.

4. Rules & Troubleshooting

The public guide describes amount as a major-unit value and supports optional currency, callback, metadata and idempotency fields.

5. Verification & Next Steps

Persist your own order ID in metadata so the payment can be reconciled with your system.