Initiate a Contractor Invoice payment

Approves the selected issued Contractor Invoices and initiates a bank-transfer payment for
them on the company's behalf, as Remote would. The invoices become pending_payment and
carry a payment reference, so the payment summary and the pay-in details of a real payment
can be read back.

Preconditions:

  • Run POST /v1/sandbox/companies/{company_id}/bypass-eligibility-checks first, so the
    legal entity has passed KYB.
  • Every contractor on the selected invoices must hold a bank-account payout method, and
    every contractor in one request must use the same payout method.
  • The company's legal entity must be able to pay in the invoice currency — its default
    currency, or one it holds an active virtual account for.
  • When the contractors are paid on Remote's licensed rails, the user initiating the
    payment must have completed identity verification.

Calling it again for invoices that are already pending_payment returns the same payment,
creates nothing new and does not retry the pay-in. If pay_in_method stays not_selected
after initiation, Remote has not recorded the pay-in: initiate a fresh batch of invoices,
or contact Remote.

This endpoint is only available in Sandbox, otherwise it will respond with a 404. There is
no pay action on the production API: payments are initiated in Remote.

Authentication

This endpoint accepts any one of the following token types:

  • Company-scoped access token (OAuth2AuthorizationCode) — obtained through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.
  • Customer API token (CustomerAPIToken) — generated by the customer on their Integration Settings page. See Authorization for customers.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Contractor Invoice payment params

The Contractor Invoices to pay in one payment.

contractor_invoice_ids
array of objects, unique
required
length between 1 and 100

Identifiers of the Contractor Invoices to pay. They must all belong to the same payer legal entity and share one currency, and each one may appear only once.

contractor_invoice_ids*
Responses

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