Create Supplier Verification Request

Runs Finexio's supplier verification workflow for a supplier. The request shape selects the kind of verification:

ACH Bank Verification — send both routing_number and account_number. Finexio runs our screening checks. When the verification succeeds, the verified bank details are applied to the supplier and its payment method is set to ACH. The supplier's stored payment method must be ACH or Check to be eligible. If any of the screening checks failed, the status will be returned as pending and the supplier will be sent an email with a secure link where they can provide required documentation to complete the requested change.

ACH Bank Enrollment — do not send routing_number and account_number. Finexio emails the supplier's primary contact an enrollment invitation and the supplier provides its bank details directly to Finexio. The supplier must have a primary contact email address. Once the banking details are received, Finexio performs screening checks and applies the change the same as the ACH Bank Verification process does.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

uuid of supplier

Body Params

Verification request body. Send routing_number + account_number for a domestic bank verification, the international object for an international one, or no bank fields to have Finexio collect the details from the supplier via an enrollment invitation.

string
enum
required

The kind of verification requested. Must be 'remit_bank_account_update'.

Allowed:
string
enum
required

Who initiated the verification request.

Allowed:
uuid

uuid of the buyer the request is made on behalf of. Required when requested_by is 'buyer'; not allowed otherwise.

string

The 9-digit ABA routing number of the domestic bank account to verify. Always sent together with account_number. Not allowed with international.

string

The domestic bank account number to verify. Always sent together with routing_number. Not allowed with international.

international
object

International banking details to verify which when present makes this an international verification.

attestation
object

The supplier's attestation that they agreed to Finexio's payment authorization disclosure. Optional; when present, all three fields are required. Domestic verification only - not accepted together with 'international'.

Responses

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json