Send connection request to a vendor

post

https://gateway.stage.bill.com/connect/v3/network/invitation/vendor/{vendorId}

Send a connection request to a vendor organization in the BILL Network. BILL automatically connects the vendor organization with the vendor record in your BILL organization.

If the vendor organization has auto-connections disabled, BILL sends an invitation email to the vendor email address. When the vendor accepts the invitation, BILL connects the vendor organization with the vendor record in your BILL organization.

If the vendor does not respond, you can delete the connection request (with DELETE /v3/network/invitation/vendor/{vendorId}) before sending a new connection request.

Note: If the vendor does not respond to the connection request for 60 days, the request expires.

See BILL Network in the Guides section for more information, sample requests, and responses.

Path Params

vendorId

string

required

length ≥ 1

BILL-generated ID of the vendor record in your organization. The value begins with 009.

Body Params

networkId

string

required

length ≥ 1

Payment Network ID (PNI) of the organization you want to connect with. For a verified national vendor, the value begins with 0rv. BILL uses the PNI to send and receive electronic payments.

You can retrieve networkId from your GET /v3/network search result.

networkType

string

enum

required

Network type.

Select BILL for BILL Network
Select RPPS for verified national vendor network

Allowed:

rppsInformation

object | null

Additional information required if networkType is RPPS

Headers

sessionId

string | null

API session ID generated with /v3/login

devKey

string | null

Developer key generated with your BILL developer account

Responses

200

Send connection request to a vendor response

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

4XXList of errors.

5XXList of errors.