Add payees

Use this when a user wants to save a recipient so they can pay it again without re-entering its details.

It creates a batch containing one or more trusted payees for the logged-in corporate or consumer identity. Once the batch completes, each payee can be referenced by beneficiaryId as the destination of a send or an outgoing wire transfer.

Payees belong to the identity that creates them and can't be shared with other identities.

Fields

Each entry in beneficiaries needs trustLevel set to TRUSTED, plus:

• beneficiaryInformation: who the payee is, as either a business (businessName) or a consumer (name and surname). Length and character limits depend on the payment details supplied below; Faster Payments and BACS are stricter than IBAN.
• beneficiaryDetails: how to pay them, as either an instrument held on the Weavr platform, used for sends, or bankAccountDetails for an external account, used for wire transfers.

group and externalRefs are yours to use (a category for filtering, and your own identifiers for the payee) and don't affect processing.

Verification is required

The batch isn't applied when you create it. The response carries an operationBatchId and a state:

While the state is PENDING_CHALLENGE, issue a challenge with one-time password or push notification, then confirm it with Verify a payee batch. Verification covers the whole batch, not individual payees.

Next steps

Read the outcome with Get a batch of payees, and the resulting payees with List payees. A payee is usable once it reaches ACTIVE.