API Reference
System Status

Nominate a bank account user

post
https://gateway.stage.bill.com/connect/v3/funding-accounts/banks/users/nominate

Nominate a bank account user.

When you nominate a user, BILL performs a set of operations.

  • The bank account user verificationStatus is set as NOMINATED.
  • BILL sends the user an email asking them to sign in to the BILL web app and complete identity verification. See Verify your identity in the Guides section for test verification information you can enter in the sandbox environment.

After user identity verification is successful, the bank account user verificationStatus is set as VERIFIED and the user can pay with the specified bank account.

Note: The bank account status must be set as VERIFIED before you can nominate bank account users.

Body Params
string
required
length ≥ 1

BILL-generated ID of the user. The value begins with 006.

string
required
length ≥ 1

BILL-generated ID of the bank account. The value begins with bac.

Note: The bank account status must be set as VERIFIED.

Headers
string | null

API session ID generated with /v3/login

string | null

Developer key generated with your BILL developer account

Responses

Updated about 1 month ago

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

Updated about 1 month ago