Skip to main content


Save Beneficiary Details

Save beneficiary information for future use.

Rapyd Disburse allows you to securely save your beneficiaries sensitive information so you can pay them in the future. Save Beneficiary Details will tokenize the information of your contractors, workers, suppliers or any business anywhere in the world.

Common Use Cases:

  • You pay out a mass amount of contract workers, or businesses.

  • You need to collect a mass amount beneficiary information from workers, or other businesses.

  • You need a way to safely store beneficiary account information to payout workers in the future.

  1. You can upload a mass beneficiary tokenization input file with beneficiaries email addresses to Client Portal. An expiration date per group of beneficiaries in one file can also be specified to set a given amount of time for the beneficiary to complete the hosted page form sent to them.

    Notify Your Users: Email Link

    The email with the link to the Save Beneficiary Details (Beneficiary Tokenization) page will be sent by Rapyd. Since this process involves providing sensitive financial information, we suggest you notify your users before this email is received (e.g. recommend adding to their list of approved addresses to avoid spam filters).

  2. Rapyd generates a beneficiary tokenization hosted page for each beneficiary and sends it by email.

  3. Each beneficiary receives a link to a hosted page by email and fills in their sensitive information (card number, bank account number etc.) on the page.

  4. The Hosted Beneficiary Account Details Page calls the Create Beneficiary API and generates a beneficiary ID for each beneficiary.

  5. In the case all beneficiaries (within one input file) fill in their details, or on the expiration time defined in the input file, the Rapyd client is notified by email that a Save Beneficiary Details output file is ready to be downloaded from Client Portal.

    • Rapyd client downloads the Save Beneficiary Details output file from Client Portal, which contains the same contents as input file with the beneficiary ID included.

    • Rapyd clients can later use these beneficiary IDs to process payouts with Rapyd using the Create Payout API or using Mass Payout via Client Portal.

Download a Beneficiary Tokenization File

The Client Portal provides sample files that serve as templates for your own beneficiary CSV file. You download the sample files from the Client Portal.

Owner or Administrator Privileges

You must have Owner or Administrator privileges to download a sample file for Save Beneficiary Details.

How to Download a Sample File
  1. Sign in as described in Accessing the Client Portal and navigate to Disburse > Beneficiary Tokenization.

    The Beneficiary Tokenization page appears.

  2. Select Instructions.

    The Instructions dialog box appears.

  3. Select Download Sample File .

    The Sample File CSV downloads.

  4. The following table describes the fields in the Sample Files panel:



    The email of the beneficiary.


    The type of entity of the beneficiary:




    Email message to the beneficiary

    beneficiary_country (optional)

    Two letter ISO 3166-1 ALPHA-2 code of the country of the beneficiary's bank account.

    payout_currency (optional)

    Currency accepted by the beneficiary’s bank account. Three-letter ISO 4217 code.

    sender_country (optional)

    Two letter ISO 3166-1 ALPHA-2 code of the country of the sender's bank account.

    sender_currency (optional)

    Currency accepted by the sender's bank account. Three-letter ISO 4217 code.

  5. The following fields are included in the csv file (although some of them do not appear in the sample file):

    • beneficiary_country

    • beneficiary_entity_type

    • beneficiary_optional_fields

    • category

    • merchant_reference_id

    • payout_currency

    • sender_country

    • sender_currency

    • sender_entity_type

  6. In each field line, enter the data for a beneficiary. Use a separate line for each beneficiary.

Upload Your Beneficiaries CSV File
  1. Go to Disburse > Beneficiary Tokenization > Upload Beneficiary File.

    The Beneficiary Tokenization Modal appears.

  2. Under Upload File, drag your file into the upload box or click to browse.

    After you select a file, the file name appears

  3. Choose the expiration date for the link the beneficiaries will receive to submit their information.

    Note: when the link expires you will be notified and the beneficiaries will no longer be able to upload their information.

  4. Tap Start Upload.

    A pop-up message confirms that your beneficiaries are being processed.

  5. In the message, tap Close .

    The Beneficiary Tokenization Reports page appears.


    The status of your report is: In Progress .

    When your report is ready, Rapyd sends you a notification by email.

    You can now use the beneficiary IDs in the report to process payouts with Rapyd Disburse using Create Payout API or using Mass Payouts via Client Portal.