---
name: onboard-sellers
description: Onboard sellers, vendors, sub-merchants and payout recipients onto a Fynex marketplace or platform. Use when the user needs to register sellers, add a vendor or supplier, collect bank details to pay someone, set up a payee, create connected accounts, or ask what a seller must provide before they can be paid. Covers payees, payout methods, the two-call setup shortcut, and which bank identifier format each currency needs.
---

# Onboard sellers on Fynex

Fynex calls the party you pay a **payee**. The party making the API call — you — is the
**seller account**. A marketplace operator is usually both at once, and confusing the two
is the single most common integration error.

## The shape

1. `POST /payments-api/v1/payees` — register the recipient.
2. `POST /payments-api/v1/payees/{payee_id}/payout-methods` — attach where their money goes.
3. Pay them: see the `handle-payouts` skill.

If you are creating both in one go, `POST /payments-api/v1/payees/setup` does steps 1 and 2
in a single call and returns the payee, the method and the cashout wallet.

To pay **yourself** — a platform withdrawing its own balance — use
`/payments-api/v1/payout-methods` instead. Same methods, but the payee is resolved
server-side, so you never name one.

## Bank details

`bankAccountType` is the identifier FORMAT, not the rail: `iban`, `uk_local`, `us_local`
or `swift`. Fynex picks the rail from the details. GBP UK-local accounts need
`currency: GBP`, `bankCountry: GB`, an 8-digit account number and a 6-digit sort code.

A payout method can be registered before it is usable — a payout against an inactive or
unapproved method fails with a code that says so rather than being queued.

## Read next

- [Payees guide](/payments-api/v2/docs/payees.md) · [Payout methods](/payments-api/v2/docs/payout-methods.md)
- [Onboarding](/payments-api/v2/docs/onboarding.md)
- [OpenAPI document](/payments-api/v2/openapi.json) · [Agent index](/payments-api/v2/llms.txt)