Make your first Merchant API call with HTTP Basic credentials.
1Pick a language
2Try It!
Loading…
Response
Click
Try It! to start a request and see the response here!This is the Merchant API (
/v1) — machine-to-machine access to vIBAN accounts, balances, transactions, beneficiaries, payouts, and one signed webhook. It is not the dashboard (no cookies, CSRF, or TOTP).
1. Get credentials
Mint a key from the dashboard Security page. You receive:
- Key id — HTTP Basic username (
vbk_test_…sandbox /vbk_live_…production) - Secret — HTTP Basic password (shown once)
See Authentication for details.
2. Base URL
Base URL: https://viban-api.enovipay.com.
Authorization: Basic base64({keyId}:{secret})
Content-Type: application/json3. First call
curl -sS -u "$KEY_ID:$SECRET" "$BASE_URL/v1/accounts"That returns your active vIBAN accounts. Use an account id as sourceAccountId on payouts.
What you can call
| Area | Start here |
|---|---|
| Accounts | List accounts |
| Balances | List balances |
| Transactions | List transactions |
| Beneficiaries | List beneficiaries |
| Payouts | Create a payout |
| Webhooks | Upsert webhook |
For a longer walkthrough, see the Quick start guide.
