API reference

Create a customer

{
  "email": "anna@example.am",
  "name": "Anna Hakobyan",
  "metadata": { "crm_id": "8891" }
}

{
  "id": "cus_1b4cf2ceec9356f1e53a3cab",
  "object": "customer",
  "email": "anna@example.am",
  "name": "Anna Hakobyan",
  "credit_balance": 0,
  "metadata": { "crm_id": "8891" },
  "created": 1786998562
}

List customers — supports ?email=

Retrieve a customer

Update a customer

Delete a customer — clears personal data, deactivates saved cards, keeps the financial record

Create a product

{
  "name": "Pro",
  "description": "For growing teams"
}

{
  "id": "prod_6f21…",
  "object": "product",
  "name": "Pro",
  "description": "For growing teams",
  "active": true,
  "created": 1786998563
}

List products

Retrieve a product

Update a product

Archive a product and every price under it. Existing subscriptions keep billing.

Create a price

{
  "product": "prod_6f21…",
  "name": "Monthly",
  "amount": 12900,
  "currency": "AMD",
  "interval": "month",
  "interval_count": 1,
  "trial_days": 14
}

{
  "id": "plan_3911175476653e621be07025",
  "object": "plan",
  "product": "prod_6f21…",
  "product_name": "Pro",
  "nickname": "Monthly",
  "name": "Pro — Monthly",
  "amount": 12900,
  "currency": "AMD",
  "interval": "month",
  "interval_count": 1,
  "trial_days": 14,
  "active": true,
  "created": 1786998563
}

List prices

Retrieve a price

Update or archive a price

Create a subscription. Without a trial, a payment method is required and the first period is charged now.

{
  "customer": "cus_1b4c…",
  "plan": "plan_3911…",
  "payment_method": "pm_77a2…",
  "quantity": 1
}

{
  "id": "sub_5c1e…",
  "object": "subscription",
  "status": "active",
  "plan": "plan_3911…",
  "quantity": 1,
  "current_period_start": 1786998600,
  "current_period_end": 1789590600,
  "trial_end": null,
  "cancel_at_period_end": false,
  "dunning_attempt": 0
}

List subscriptions — supports ?status=

Retrieve a subscription

Change plan with proration. An upgrade charges the difference now; a downgrade credits the customer.

{ "plan": "plan_bigger…", "prorate": true }

{
  "id": "sub_5c1e…",
  "status": "active",
  "plan": "plan_bigger…",
  "proration": { "charged": 19677, "credited": 0, "payment": "pay_aa31…" }
}

Cancel now, or at period end with { "at_period_end": true }

Pause billing without canceling

Resume — the paused gap is never billed

Charge a saved card off-session — the same call the recurring engine makes

{
  "amount": 45000,
  "currency": "AMD",
  "customer": "cus_1b4c…",
  "description": "September retainer"
}

{
  "id": "pay_a348cb5b0664660d4c29d890",
  "object": "payment",
  "amount": 45000,
  "currency": "AMD",
  "status": "succeeded",
  "type": "one_off",
  "attempt": 1,
  "is_recovery": false,
  "created": 1786998900
}

List payments — supports ?status=

Retrieve a payment

Refund in whole or part. The platform fee on the refunded amount is reversed.

{ "amount": 20000, "reason": "duplicate" }

{
  "id": "re_66b1…",
  "object": "refund",
  "payment": "pay_a348…",
  "amount": 20000,
  "status": "succeeded"
}

List refunds

Open a hosted checkout. type is payment, setup or subscription.

{
  "type": "payment",
  "amount": 25000,
  "currency": "AMD",
  "description": "September membership",
  "customer_email": "anna@example.am",
  "save_card": true,
  "success_url": "https://yourapp.am/thanks"
}

{
  "id": "cs_f4accee46724b73fae2ced5a",
  "object": "checkout_session",
  "status": "processing",
  "amount": 25000,
  "url": "https://ronda.sh/checkout/cs_f4ac…",
  "expires_at": 1787000363
}

Retrieve a session and its outcome

List saved cards — supports ?customer=

Detach a card and deactivate the binding at the bank

Create a payment link

{ "name": "September invoice", "amount": 45000 }

{
  "id": "link_71c2…",
  "object": "payment_link",
  "url": "https://ronda.sh/pay/pl_8f1c…",
  "amount": 45000,
  "status": "active",
  "use_count": 0
}

List links

Activate or deactivate a link

Raise an invoice and send it

{
  "customer": "cus_1b4c…",
  "collection_method": "send_invoice",
  "days_until_due": 14,
  "memo": "Thank you",
  "lines": [
    { "description": "Consulting, March", "quantity": 2, "unit_amount": 150000 }
  ]
}

{
  "id": "inv_9d02…",
  "object": "invoice",
  "number": "2026-0042",
  "status": "open",
  "collection_method": "send_invoice",
  "subtotal": 300000,
  "discount": 0,
  "total": 300000,
  "due": 1788208563,
  "hosted_url": "https://ronda.sh/invoice/ivt_…",
  "created": 1786998563
}

List invoices, filterable by status and customer

Retrieve an invoice with its line items

Void an invoice. It keeps its number — the sequence stays gapless — and stops being payable.

Create a coupon — a percentage or a fixed amount, never both

{
  "code": "SUMMER25",
  "percent_off": 25,
  "duration": "repeating",
  "duration_in_months": 3,
  "max_redemptions": 100
}

{
  "id": "cpn_74b1…",
  "object": "coupon",
  "code": "SUMMER25",
  "percent_off": 25,
  "duration": "repeating",
  "duration_in_months": 3,
  "max_redemptions": 100,
  "times_redeemed": 0,
  "valid": true,
  "created": 1786998563
}

List coupons

Retrieve a coupon by id or by code

Archive a coupon

Apply a coupon to a subscription. It takes effect from the next renewal.

{ "coupon": "SUMMER25" }

Register an endpoint. The signing secret is returned once.

{ "url": "https://yourapp.am/ronda/webhook", "enabled_events": ["payment.succeeded"] }

List endpoints

Delete an endpoint

List events — supports ?type=

Retrieve an event

List chargebacks

Collected, pending, settled and fees — derived from the ledger

{
  "object": "balance",
  "currency": "AMD",
  "available": 1284000,
  "pending": 96000,
  "gross": 1420000,
  "refunded": 25000,
  "fees": 7100,
  "settled": 1180000,
  "mode": "live"
}