Create Payout Recipients

Facades: payout

Overview

Allows a merchant to invite clients to sign up for a BitPay personal account.

  • For merchants who need to invite multiple recipients in a short period of time, make sure to send batch of invites e.g. use this endpoint to invite an array [] of recipients (up to 1000 in a single API call)
  • By default a merchant can invite a maximum of 1000 distinct recipients via the business account. Reach out to your account manager at BitPay in order to increase this limit.

Parameters

ParameterDescription
recipientsA PayoutRecipients object with request parameters defined.

Example

List<PayoutRecipient> recipientsList = Arrays.asList(
    new PayoutRecipient(
            "[email protected]",
            "recipient1",
            "https://hookb.in/wNDlQMV7WMFz88VDyGnJ"),
    new PayoutRecipient(
            "[email protected]",
            "recipient2",
            "https://hookb.in/QJOPBdMgRkukpp2WO60o"),
    new PayoutRecipient(
            "[email protected]",
            "recipient3",
            "https://hookb.in/QJOPBdMgRkukpp2WO60o")
);

PayoutRecipients recipientsObj = new PayoutRecipients(recipientsList);
List<PayoutRecipient> recipients = bitpay.submitPayoutRecipients(recipientsObj);