Create Seller

post

https://sandbox.finmid.com/api/v2/b2b-payments/sellers

Let's create/onboard a new seller. For this you'll need 2 things:

Create a new ID for this seller (should map to your internal identifier)
The seller's legal information. ⚠️ Note that one of either business_registration_number or tax_number must be provided on creation.

📘
You should create a seller entity for every seller on your platform that can be part of a lending transaction.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

string

required

length ≤ 100

^[a-zA-Z0-9_\.\-]{1,100}$

Custom ID of the seller, should map to your internal identifier. Must consist only of a-z, A-Z, 0-9 and .-_ characters, and length should not exceed 100 characters.

legal_name

string

required

length ≤ 100

Business name of the seller (not necessarily the brand name). This should be the name as stated in official business registers.

business_registration_number

string

length ≤ 100

Registration number of the seller from the commercial register.

tax_number

string

length ≤ 100

Identification number assigned to the seller by local tax office.

string

required

^(?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[a-zA-Z0-9-]*[a-zA-Z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])$

Email address of the seller.

phone

string

length between 4 and 30

^\+[0-9]+$

Phone number of the seller. Must be provided in the international format, e.g. +49123456789.

legal_address

object

required

Legal address of the seller.

bank_accounts

array

required

Bank account details used for payouts to seller
Note: only one bank account allowed per currency.

bank_accounts*

Responses

401

Missing or invalid API key. Could not authenticate API request.

200The seller was created successfully.

409Seller exists already.

500An unexpected server error occurred. You should try again later or contact finmid support.