ElevenLabs Agents

Add card-on-file payments to an ElevenLabs agent two ways. Hosted transfers the call to Ringup at payment time; Ringup runs the whole payment and you write no payment logic. In your agent keeps the caller in your agent the whole call: webhook tools recognize the caller and charge their saved card, and nothing transfers. Either way a recognized caller never reads a card aloud, so no card data touches your agent.

Prerequisites

An ElevenLabs agent you already run, with a phone number.
Your ElevenLabs API key, and a Ringup API key.

Set up

Using Dashboard
Using Tools

Ringup takes payment on a transfer. Best when you want the payment moment handled for you.

The hosted transfer needs the agent’s number attached over a SIP trunk. ElevenLabs allows a SIP-URI transfer destination only with sip_refer and rejects that combination on a native-Twilio number, so such an agent cannot reach the payment line by transfer. If your number cannot transfer, use the Using Tools tab, which never transfers.

Preview. The transfer transport is live: an agent on a SIP-trunk number can refer the call to the payment line. Matching the transferred call to the order registered by the caller’s number is still in build. Confirm availability in your Ringup dashboard before relying on the hosted path in production. The Using Tools tab works today.

Connect ElevenLabs, once for your account

In the Ringup dashboard, open Voice integrations, then Connect ElevenLabs, and paste your ElevenLabs API key. Ringup uses it to list your agents and provision the payment objects, and never stores it. One connection covers every merchant you run.

Pick the agents that take payments

Select the agents that answer merchant calls. Ringup registers identify (called at the greeting) and create_checkout on each and pins your payment address in the agent’s transfer rule; paste the one prompt line the dashboard shows. No per-merchant step: the merchant resolves from the dialed number, and activates when it connects its processor.

Add your webhook endpoint

Under Webhooks, add your HTTPS endpoint and copy the signing secret. Ringup posts a signed checkout.succeeded there for every payment. See Webhooks.

Rehearse on the rehearsal number, then go live

The dashboard binds a test twin of your agent to a rehearsal number. Call it from your own phone and order: on your first call you are texted a link and pay with the test card 4111 1111 1111 1111 (any future expiry, any CVC); on the next call you pay on the saved Visa ending 1111, no real charge. When it reads a confirmation code back, click Go live.

Keep the caller in your agent and add four ElevenLabs webhook tools pointed at Ringup, authed with your Ringup key. caller_phone is pinned to the system__caller_id dynamic variable and merchant_id to a per-merchant one, so the model never types either identity, and nothing transfers.

Recognize the caller at the greeting

Add a webhook tool identify and call it at the greeting, not at payment. For a returning caller it returns their name, so your agent greets them by name and skips questions it can already answer. An unknown caller comes back known: false, an ordinary first call. See Recognize at the start of the call.

{
  "type": "webhook",
  "name": "identify",
  "description": "Recognize the caller at the greeting. Returns their name if Ringup knows them.",
  "api_schema": {
    "url": "https://api.ringup.dev/v1/identify",
    "method": "POST",
    "request_headers": { "Authorization": "Bearer <YOUR_RINGUP_KEY>" },
    "request_body_schema": {
      "type": "object",
      "properties": {
        "caller_phone": { "type": "string", "dynamic_variable": "system__caller_id" }
      },
      "required": ["caller_phone"]
    }
  }
}

Open a Checkout Session when the order is confirmed

Add a webhook tool create_checkout. It resolves the total, applies the merchant’s payment policy, and returns cards: the caller’s cards chargeable at this merchant. If payment_required is none, say nothing about payment and finish the call.

{
  "type": "webhook",
  "name": "create_checkout",
  "description": "Open a payment session for the confirmed order. Returns whether payment is required and which saved cards can be used.",
  "api_schema": {
    "url": "https://api.ringup.dev/v1/create_checkout",
    "method": "POST",
    "request_headers": { "Authorization": "Bearer <YOUR_RINGUP_KEY>" },
    "request_body_schema": {
      "type": "object",
      "properties": {
        "merchant_id":  { "type": "string", "dynamic_variable": "merchant_id" },
        "caller_phone": { "type": "string", "dynamic_variable": "system__caller_id" },
        "order_id":     { "type": "string", "description": "The merchant's order id, if you have one. Ringup reads the total from it." },
        "amount_cents": { "type": "number", "description": "Order total in cents. Required only when there is no order_id." }
      },
      "required": ["merchant_id", "caller_phone"]
    }
  }
}

Charge the card the caller picked

Add a webhook tool charge. Read one card from cards back by brand and last four with the amount, and call charge only after the caller agrees, with that card’s instrument_id.

{
  "type": "webhook",
  "name": "charge",
  "description": "Charge the card the caller agreed to. Use the checkout_session_id and the instrument_id of the card you read back.",
  "api_schema": {
    "url": "https://api.ringup.dev/v1/charge",
    "method": "POST",
    "request_headers": { "Authorization": "Bearer <YOUR_RINGUP_KEY>" },
    "request_body_schema": {
      "type": "object",
      "properties": {
        "checkout_session_id": { "type": "string", "description": "From create_checkout" },
        "instrument_id":       { "type": "string", "description": "The card the caller agreed to, from the session's cards" }
      },
      "required": ["checkout_session_id", "instrument_id"]
    }
  }
}

Text a link when there is no card to offer

Add a webhook tool send_link for a session whose cards is empty (or after a declined charge). Ringup texts a secure pay link and, when they pay, pushes the confirmation back into the live call (or sends it by SMS if the call has ended).

{
  "type": "webhook",
  "name": "send_link",
  "description": "Text the caller a secure pay link for this session. Use when the session returned no cards.",
  "api_schema": {
    "url": "https://api.ringup.dev/v1/send_link",
    "method": "POST",
    "request_headers": { "Authorization": "Bearer <YOUR_RINGUP_KEY>" },
    "request_body_schema": {
      "type": "object",
      "properties": {
        "checkout_session_id": { "type": "string", "description": "From create_checkout" }
      },
      "required": ["checkout_session_id"]
    }
  }
}

Then add one line to your prompt: when the caller has confirmed the order, call create_checkout; if it returns cards, read one back and call charge after they agree, then read back the order id as the confirmation; if it returns none, call send_link and tell them to check their text to pay.

Add your webhook endpoint

In the Ringup dashboard under Webhooks, add your HTTPS endpoint and copy the signing secret. Your server verifies the signature and handles checkout.succeeded. See Webhooks.

Test it, then go live

Keep the tools’ url on https://api.ringup.dev/v1 and auth with your rk_test_ key. Call your agent from your own phone and order: on your first call you are texted a link and pay with the test card 4111 1111 1111 1111 (any future expiry, any CVC); on the next call you are recognized and pay on the saved Visa ending 1111. Expect the confirmation read back and a test-mode checkout.succeeded. Swap in your rk_live_ key to go live.

Before you go live: add the Connect button to your dashboard. Wiring the payment tools into your agent does not, by itself, let any charge settle. Each merchant must first connect their own payment processor, from a button you embed on your merchant-facing dashboard:

<script src="https://ringup.dev/connect/button.js"
        data-ringup-key="pk_test_..."></script>

That is your publishable key, not your secret one. Ship it alongside this integration so a merchant can connect the moment they are ready; until they do, the payment layer stays inaudible on their calls, so going live early is safe. Button options and the connect flow: Payment providers.

Get started

Concepts

Developer integrations

Merchant integrations

ElevenLabs Agents

Prerequisites

Set up

Next steps

Testing

Webhooks

​Prerequisites

​Set up

​Next steps

Testing

Webhooks

Prerequisites

Set up

Next steps