> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dintero.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.dintero.com/feedback

```json
{
  "path": "/docs/partners/inviting-merchants",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Inviting merchants as a Dintero partner

> Use the Dintero Partner API to invite merchants for onboarding so they can accept Dintero's terms of service and start accepting payments under your account.

# Partner API

This documentation covers how a partner of Dintero can use the API to invite their merchants.

## Inviting merchants

It is important that the merchant completes the onboarding to the Dintero systems themselves
so that they can accept Dintero's terms of service. See also our [Legal Documents](https://www.dintero.com/legal).

When inviting a new merchant you can set an optional `signup_reference` query parameter in the
Dintero onboarding url that will be added to the `applicant` object on the new merchant account.

We have two alternative flows for creating new merchants that belong to a *partner account*.

### Alternative 1: self-serviced onboarding

The partner will link to the Dintero onboarding form, the merchant will have
to submit their details and accept the terms of service. The merchant will receive an email
with a code to verify their email address and then create a password for their new Dintero account.

#### URL to the self service onboarding

```
https://onboarding.dintero.com/?partner={partner_id}&signup_reference={signup_reference}
```

Example: `https://onboarding.dintero.com/?partner=112&signup_reference=abc-123`

### Alternative 2: prefilled onboarding

The merchant will receive an email with a link to a prefilled form, the merchant can edit their details
and accept the terms of service. Once accepted the merchant will create a password for their new Dintero account

#### URL to the prefill form

This is the form a *partner* uses to invite a new user

```
https://onboarding.dintero.com/prefill?partner={partner_id}&signup_reference={signup_reference}
```

Example: `https://onboarding.dintero.com/prefill?partner=112&signup_reference=abc-123`

## Get notified when your merchants are onboarded

Subscribe to the `account_add` and `account_update` webhooks to be notified when a new merchant is onboarded or when the merchant changes their information.

* [Subscribe to webhooks API reference](https://docs.dintero.com/webhooks-api.html#operation/aid_source_hooks_post)