1. Subscriptions
KuvarPay API
  • Overview
  • SDK Integration Guide
  • Webhooks Integration Guide
  • Subscriptions Guide
  • Split Payment Guide
  • Transactions
    • Calculate Payment Amount
    • Create Transaction
    • Get Transactions Details
    • Get Transactions
    • Update Status
    • Get Transaction Status by Reference
    • Simulate payment for sandbox transactions
    • Get detailed payment status for a transaction
    • Manually trigger refund for excess payment
    • Get list of expired transactions
  • Checkout Sessions
    • Arm Checkout Session
    • Payment Status Webhook
    • Cleanup Expired Sessions
    • Create Checkout Session
    • Get Checkout Session
    • Update Checkout Session
  • Transfer Fees
    • Get Optimal Transfer Fee
    • Get Transfer Fee
    • Get all stored transfer fees from database
    • Update Transfer Fees
    • Get currencies supported for transfers
  • Sandbox Simulator
    • Start the sandbox transaction simulator
    • Stop the sandbox transaction simulator
    • Get Simulator Status
    • Force Simulator Scenario
    • Update simulator configuration
    • Force Transaction Status
    • Get Pending Transactions
    • Reset Sandbox Transactions
  • Invoices
    • Create a new invoice
    • Send invoice email to customer
  • Payment Links
    • Create a new payment link
  • Server-Sent Events (SSE)
    • Get Transaction Details
    • Get Session Details
    • Get Health
  • Subscriptions
    • Create Plans
      POST
    • Get Plans
      GET
    • Get Plans Details
      GET
    • Update Plans Details
      PATCH
    • Create Prices
      POST
    • Get Prices
      GET
    • Update Prices Details
      PATCH
    • Create Checkout Sessions
      POST
    • Get Checkout Sessions Details
      GET
    • Confirm Subscription Checkout
      POST
    • Create Subscriptions
      POST
    • Get Subscriptions
      GET
    • Get Subscriptions Details
      GET
    • Update Subscriptions Details
      PATCH
    • Delete Subscriptions Details
      DELETE
    • Confirm Subscription Cancellation
      POST
    • Renew Subscription
      POST
    • Upgrade Subscription
      POST
    • Downgrade Subscription
      POST
    • Renew Subscription Authorization
      POST
    • Create Subscription Invoices
      POST
    • Get Subscription Invoices
      GET
    • Create Metered Invoices
      POST
    • Get Subscription Invoices Details
      GET
    • Charge Subscription Invoice
      POST
    • Get Charge Attempts
      GET
    • Create Authorizations
      POST
    • Revoke Relay Authorization
      POST
    • Get Relay Authorization Status
      GET
  • Currencies
    • Get Subscription Currencies
    • Get networks supported for subscription payments
    • Get Currencies
    • Get all supported networks
    • Get Item Details
    • Manually fetch currencies from ChangeNOW API
    • Get currency statistics
    • Get Supported Currencies
  • Subaccounts
    • Create Subaccount
    • List Subaccounts
    • Get Subaccount Details
    • Update Subaccount
    • Delete Subaccount
  • Split Group
  • Banks
    • List supported banks
    • Resolve bank account
    • List banks by currency
    • Verify account (Legacy)
  • Requirements
    • Create Verify Balance
  • Payment Fiat Rates
    • Get Item Details
    • Create Batch
    • Get Item Details
    • Get Currencies
    • Get Item Details
    • Get Fiat Rate Details
    • Get Fiat Rates
    • Create Update Ngn
    • Create Update All
    • Get Item Details
  • Split Payments
    • Create Split Group
    • List Split Groups
    • Get Split Group Details
    • Update Split Group
    • Delete Split Group
  • Schemas
    • ErrorResponse
    • CreateInvoiceRequest
    • CreatePaymentLinkRequest
    • InvoiceResponse
    • PaymentLinkResponse
    • CreateInvoiceResponse
    • CreatePaymentLinkResponse
    • SendInvoiceEmailRequest
    • SendInvoiceEmailResponse
    • SubscriptionInvoice
Home
Home
  1. Subscriptions

Charge Subscription Invoice

POST
/api/v1/subscriptions/subscription-invoices/{id}/charge
Subscriptions

Request

Authorization
API Key
Add parameter in header
X-API-Key
Example:
X-API-Key: ********************
API Key
Add parameter in header
X-Business-ID
Example:
X-Business-ID: ********************
or
Path Params

Body Params application/json

Examples

Responses

🟢200
application/json
Default Response
Body

🟠400
🟠409
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/subscriptions/subscription-invoices//charge' \
--header 'X-API-Key: <api-key>' \
--header 'X-Business-ID: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "force_retry": false,
    "metadata": {}
}'
Response Response Example
200 - Example 1
{
    "success": true,
    "data": {
        "invoice": {
            "uid": "string",
            "status": "string",
            "attempt_count": 0,
            "next_payment_attempt": "string",
            "processing": true
        },
        "charge_attempt": {
            "uid": "string",
            "status": "string",
            "transaction_hash": "string",
            "block_number": 0,
            "gas_used": "string",
            "error_message": "string",
            "created_at": "string"
        }
    }
}
Modified at 2026-04-14 01:46:40
Previous
Get Subscription Invoices Details
Next
Get Charge Attempts
Built with