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 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.
Scopes
| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
View pay-in bank details (pay_in_details) | View pay-in details (pay_in_details:read) | - |
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||