Shows how the payment that collects a Contractor Invoice is paid in, and where to send it.
bank_accounts carries Remote's receiving accounts while status is awaiting_payment.
It is null once the funds are in flight or received, while the payment sits on a compliance
hold (blocked) or is partly paid (partially_paid, where amount_due overstates what
remains and Remote follows up with the balance directly), and whenever Remote has no
account to publish.
pay_in_method says whether a transfer is yours to send at all: Remote collects
direct_debit, card and prefunding_credit payments itself, and a transfer would pay the
same invoices twice. That holds after a failed or disputed collection too: the payment reads
awaiting_payment with its method unchanged until the company retries it in Remote, so a
failed debit is not an invitation to wire, even when accounts are present. Accounts can
differ from one payment to the next, so read them before every transfer rather than storing
them.
The endpoint answers 404 only while no payment stands behind the invoice. A passing
database fault surfaces as a 504 or a 500; retry either.
Authentication
This endpoint accepts any one of the following token types:
- Company-scoped access token (
OAuth2AuthorizationCode) — obtained by a company manager through the Authorization Code flow or the Refresh Token flow. See Authentication for partners. - Company-scoped access token (assertion) (
OAuth2CompanyManagerAssertion) — obtained through theurn:ietf:params:oauth:grant-type:jwt-bearergrant for a company manager. See OAuth Assertion. - Customer API token (
CustomerAPIToken) — generated by the customer on their Integration Settings page, with the scopes they choose there. See Authorization for customers.
Scopes
Any one of the scopes in a token type's row is enough. all:read and all:write work too.
| Token type | Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|---|
| Company-scoped access token | View pay-in bank details (pay_in_details) | View pay-in details (pay_in_details:read) | - |
| Company-scoped access token (assertion) | View pay-in bank details (pay_in_details) | View pay-in details (pay_in_details:read) | - |
| Customer API token | View pay-in bank details (pay_in_details) | View pay-in details (pay_in_details:read) | - |
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||