Connected Accounts

If you’re building a platform or marketplace, and you want to:

• Charge on behalf of someone else, or
• Share revenue with other accounts

Connected Accounts is for you.

With Connected Accounts you can charge on behalf of other accounts using your own API keys, without needing access to their API keys.

How do I connect two accounts?

This is done through the Recurrente UI. Follow the instructions here.

Create a checkout for a connected account

Once accounts are connected, you can create checkouts on behalf of the child account using the custom_account_id parameter:

$
curl -X POST https://app.recurrente.com/api/checkouts \
>
  -H "X-PUBLIC-KEY: your_public_key" \
>
  -H "X-SECRET-KEY: your_secret_key" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "items": [
>
      {
>
        "currency": "GTQ",
>
        "amount_in_cents": 3000,
>
        "name": "Example product"
>
      }
>
    ],
>
    "custom_account_id": "ac_123456"
>
  }'

Fund distribution

You can distribute funds between accounts using transfer_setups:

1
{
2
  "items": [
3
    {
4
      "currency": "GTQ",
5
      "amount_in_cents": 3000,
6
      "name": "Example product"
7
    }
8
  ],
9
  "custom_account_id": "ac_123456",
10
  "transfer_setups": [
11
    {
12
      "amount_in_cents": 100,
13
      "recipient_id": "ac_789012"
14
    }
15
  ]
16
}

Webhooks

When events occur in a child account, you’ll receive webhooks with additional parameters:

• connected: true — indicates the event was generated by a connected account
• account_id: "ac_123456" — the ID of the account that generated the event

You can use these fields to identify and process connected account events separately.