In accounts payable (AP), C3s are the vendor entities that want to send invoices to their customers. They can be individuals or businesses.

In Mercoa, you’ll need to create a vendor for each vendor that your customers will be paying invoices to through your platform.

Creating Vendors

Vendors can be created in the dashboard or with the create entity endpoint, and linked to a customer using the link payees endpoint.

They will also automatically be created and linked when a customer adds a new vendor through the React component or embed.

Creating the Vendor Entity

Using the create entity endpoint, create a new entity, and make sure the following fields are set:

1
{
2
  isPayee: true // This marks the entity as able to receive funds
3
  isPayor: false // This marks the entity as unable to pay funds
4
  isCustomer: false // This indicated that you don't have a direct relationship with this entity (aka, they are your customer's vendor)
5
}

This will automatically add the vendor to the platform network.

Capturing Vendor Details

If you don’t have the vendor’s details, you can use the generate onboarding link endpoint to create a link that the vendor can use to provide their details. This link will be valid for 24 hours. You can also use the send onboarding email endpoint to send the link to the vendor via email. This link will be valid for 7 days, and will be emailed to the entity email.

You can configure what details are required for the vendor using the dashboard or api.

Adding the Vendor to the Payer as a Counterparty

Once the vendor entity is created, you need to link it to the payer.

You can link the vendor to any entity using the link payees endpoint. This will create a relationship between the two entities, and allow the payer to pay the vendor.

For example, if you have a payer Entity with id ent_8545a84e-a45f-41bf-bdf1-33b42a55812c, and a vendor Entity with id ent_21661ac1-a2a8-4465-a6c0-64474ba8181d, you can link them using the following request

Finding Counterparties

Once you have created and linked vendors to the payer, you can use the get counterparties endpoint to find the vendors linked to the payer.

Hiding / Archiving Counterparties

If you don’t want a counterparty to show up for an Entity in the counterparty search, you can hide them using the hide payee from search endpoint.

Verifying Vendors

If you’re using Mercoa’s built-in payment rails, your C3 entities will need some information to receive payments successfully. However, they will not need to undergo a formal KYB verification process.

Vendor (C3) KYB Requirements