# Fina Pay API

> Charges, payment links, payouts and signed webhooks for any store, app or backend.

Charges, payment links, payouts and signed webhooks for any store, app or backend.

| Field | Value |
| --- | --- |
| Base URL | `https://fina.do/api/wallet/v1` |
| Authentication | Bearer secret key (`sk_live_…`) from the Fina Pay connector of your business |
| OpenAPI 3.1 | [/api/wallet/v1/openapi.json](https://fina.do/api/wallet/v1/openapi.json) |
| Built for | Merchants and developers integrating payments |

Webhooks are part of the spec too (`webhooks` in OpenAPI 3.1). Guides: [Quickstart](https://fina.do/developers/quickstart.md), [Charges](https://fina.do/developers/charges.md), [Webhooks](https://fina.do/developers/webhooks.md).

### Endpoints

Base URL: `https://fina.do/api/wallet/v1`

| Method | Path | Summary | Auth |
| --- | --- | --- | --- |
| GET | `/charges` | Look up a charge by payment token (public key) | Public |
| POST | `/charges` | Create a charge and get its payment URL | Secret key |
| GET | `/charges/{id}` | Get a charge (poll its status, fee and net) | Secret key |
| POST | `/charges/{id}/cancel` | Cancel a pending charge | Secret key |
| POST | `/payouts` | Pay a Fina Pay user from your wallet | Secret key |
| GET | `/payouts/{id}` | Get a payout of this connection | Secret key |
| GET | `/recipients` | Look up who will receive a payout | Secret key |

Source: https://fina.do/developers#api-fina-pay