LirPay
OpenAPI

Changelog

More currencies for checkout and Cloud payments

Pay with BNB, GRAM, LTC, POL and ARB. Checkout deposits go directly to Bybit, including supported USDT, USDC and USDE networks. Cloud accepts these currencies from your available LirPay balance. Default Bybit auto-sale still credits USDT; convert funds or choose an autoswap destination to pay in another currency.

Payment currencies and balance units

Manage your LirPay Cloud applications

Edit application details, callbacks, and permissions. Rotate secrets, pause or resume apps, and inspect connection history. Disconnect individual accounts or all accounts. Removed permissions stop working immediately; added permissions require fresh consent.

OAuth protocol and permissions

Connect applications with LirPay Cloud OAuth

Register an app in Integrations → LirPay Cloud. Merchants choose the permissions to grant, including separate read and write access. Connections use PKCE, short-lived access tokens, and rotating refresh tokens with offline access. Disconnect an app at any time. Existing API keys continue to work.

OAuth protocol and permissions

Set the webhook URL in each request

Saved webhook addresses are deprecated. Send webhook_url in POST /payment-links, POST /withdrawals, POST /conversions, or POST /fulfillments. The request URL receives the signed event and remains the destination for retries and redelivery.

{
  "display_name": "Order 1042",
  "amount": "25.00",
  "currency": "USD",
  "project_id": "6d14a419-a00b-4fc0-9613-9c8959ed20c2",
  "webhook_url": "https://merchant.example/webhooks/lirpay"
}

Existing saved URLs still work during the transition when a request omits webhook_url. Once compatibility ends, omitted URLs mean no webhook delivery and the URL setting will disappear.

In Settings, Generate secret creates a random signing secret. Copy secret copies it to your clipboard; Save activates it. Existing environment-specific secrets are preserved. The preferred settlement currency control has been removed.

Webhook migration guide

Dashboard links use live mode

The dashboard test-mode switch has been removed. New dashboard and project checkout links use live payments. Test API keys remain available for sandbox integrations.