Connect a payment provider
When you connect your own payment account, clients pay for services and shoots directly to you. Osvio never receives or holds this money. You connect a provider under Settings → Payments.
Until a provider is connected, clients see the payment links from your service settings.
Connect a provider¶
- Open Settings and select the Payments tab.
- Choose a Payment provider: Monobank, LiqPay, Stripe or PayPal.
- Enter the details for that provider (below) and choose a Currency. Use Sandbox (test mode) if you want to try it with test payments first.
- Select Check & save. Osvio verifies the details with the provider. When it works, the provider shows as Verified and Active.
What each provider needs¶
| Provider | What to enter | Where to find it |
|---|---|---|
| Monobank | X-Token | web.monobank.ua → Internet acquiring → Settings |
| LiqPay | Public key and Private key | LiqPay dashboard: Company settings → API. The webhook is set up automatically. |
| Stripe | Secret or restricted key | Create a restricted key in Developers → API keys with write access to Checkout Sessions and Webhook Endpoints. Osvio creates the webhook for you. Use a secret (sk_…) or restricted (rk_…) key, not a publishable one (pk_…). |
| PayPal | Client ID and Secret | Create a REST app at developer.paypal.com → Apps & Credentials. PayPal doesn't accept UAH, so prices will be in the currency you choose. |
Your service prices are shown in the currency you choose here.
Switch or disconnect¶
- With several providers connected, select Use this one to choose which is active.
- Disconnect deletes the saved keys. Clients then see your own payment links again.
If it doesn't connect¶
- "The payment provider rejected these keys": check you copied them correctly and that they have the right permissions.
- "The payment provider is not responding": try again in a minute.
Where it's used¶
- Services that clients order in your galleries: Offer prints and extra services.
- Payment links for shoots: Take payment for a shoot.