# BlikPay Merchant App API Docs

This folder contains docs for the Android developer.

Files:
- `openapi.yaml` (Swagger / OpenAPI 3.0)
- `postman_collection.json` (Postman Collection v2.1)

## Swagger / OpenAPI

Load:
- `api/docs/openapi.yaml`

Update:
- `https://your-api-domain.com` -> your real API base URL

## Postman

Import:
- `api/docs/postman_collection.json`

Main variables:
- `base_url`
- `email`
- `device_id`
- `otp_id`
- `otp`
- `app_token`

Optional report variables:
- `txn_type`
- `txn_status`
- `txn_provider`
- `txn_from`
- `txn_to`
- `txn_search`
- `ledger_wallet`
- `ledger_type`
- `ledger_from`
- `ledger_to`
- `ledger_search`

## Auth Flow

1. Request OTP
- `POST /api/gatewayuser/login/request-otp`

2. Verify OTP
- `POST /api/gatewayuser/login/verify-otp`

3. Use returned `app_token`
- Header: `X-App-Token: <app_token>`

4. Logout
- `POST /api/gatewayuser/logout`

## Portal APIs

- Balance:
  `GET /api/gatewayuser/balance`

- Transaction reports:
  `GET /api/gatewayuser/transaction-reports`

- Ledger:
  `GET /api/gatewayuser/ledger`

## Notes

- Protected APIs require `X-App-Token`
- Optional tracking headers:
  - `X-App-Platform`
  - `X-App-Version`
- Date filters use `YYYY-MM-DD`
- Supported page limits: `25`, `50`, `100`, `200`