The Rivo Business API exposes authenticated endpoints for initiating payments and creating payment links inside your own product experience. These docs focus on the API surfaces needed for these business operations.

What you can build

Payments

Initiate a payment checkout session for your customers. Your application provides the amount, currency, and customer details, and we return a redirect URL where the customer can securely complete the payment. Programmatically create shareable payment links for campaigns or simple checkout flows. You can list all active links and expire them when they are no longer needed.

How it works

  1. Your backend calls the Rivo Business API using your authorized API key.
  2. Rivo processes the requested payment or payment link action.
  3. You handle the response and present the outcome to your users.
  4. Listen to Webhooks for async updates on payment status.
Do not expose Rivo credentials or authorization values in frontend code, analytics tools, public workspaces, or support tickets.

What is covered

  • Authentication requirements for protected requests
  • Initiating Payments
  • Managing Payment Links

Base URL

https:business-api.userivo.co/business/v1
Use the sandbox URL while building and testing.
https://sandbox-api.userivo.co/business/v1

Response format

Rivo Business responses use a consistent JSON shape.
{
  "status": "success",
  "message": "success",
  "data": {}
}
Errors use the same shape with status set to error.
{
  "status": "error",
  "message": "Unauthorized access",
  "data": null
}

Next step

Start with Quickstart, then read Authentication and Payment Links before making test calls.