# FastPayGlobal SDKs

Official client libraries for the FastPayGlobal payment API.
Base URL: `https://demo.fastpayglobal.app`

| Language    | Path                              | Install / Use |
|-------------|-----------------------------------|---------------|
| PHP         | `/sdk/php/FastPayGlobal.php`      | `require 'FastPayGlobal.php';` |
| Node.js     | `/sdk/node/fastpayglobal.js`      | Copy or `npm i ./node` |
| Python      | `/sdk/python/fastpayglobal.py`    | `pip install requests` then drop in |
| Browser JS  | `/sdk/browser/fastpayglobal.js`   | `<script src="...">` |
| HTML demo   | `/sdk/html/example.html`          | Open in browser |
| React hook  | `/sdk/react/useFastPayGlobal.js`  | `import { useFastPayGlobal } from './useFastPayGlobal'` |
| Android     | `/sdk/android-sdk-1.0.0.aar`      | Add as a Gradle dependency |
| iOS         | `/sdk/ios-sdk-1.0.0.zip`          | Drag & drop framework |

All SDKs implement the same flow:
**createPayment → open hosted URL → poll status → optional verify(trxId)**

States: `pending` → `awaiting_confirmation` → `paid` / `expired` / `failed` / `cancelled`

Error codes: `network_error`, `api_error_4xx/5xx`, `timeout`.

Webhooks: verify HMAC-SHA256 of raw body using your `webhook_signing_secret`,
sent in the `X-Signature` header.