Streamline recipient management and enhance transaction security with the Beneficiary Registry API. By pre-registering beneficiaries, you create a reusable profile that ensures data integrity across multiple payment rails—including ACH, WIRE, and SWIFT—while significantly reducing the operational complexity of subsequent transfer requests.

This centralized registry captures essential routing instructions, bank metadata, and mandatory regulatory address data in a single, indexable record.

Implementation & Compliance Steps

To successfully register a beneficiary, follow this recommended sequence:

1. Categorization: Identify if the recipient is an Individual or an Entity and determine the primary payment rails they support (e.g., ACH vs. SWIFT).
2. Routing Configuration: Collect and validate bank account numbers, routing numbers (ABA), or international SWIFT/BIC codes.
3. Regulatory Mandate: For WIRE and SWIFT rails, a physical recipient address is a mandatory requirement. You must provide valid stateCode and countryCode values to clear downstream compliance checks.
4. Transaction Integration: Once created, utilize the returned resourceId as the recipientId when initiating transfers via the Transfers API.

Operational Benefits

• Reduced Payload Complexity: Eliminate the need to repeat sensitive banking and address details for every transaction.
• Improved Accuracy: Centralized management minimizes risk by preventing typographical errors in critical routing fields during transfer initiation.
• Cross-Rail Flexibility: Configure a single recipient profile with multiple set of instructions to support diverse regional or international payment methods.

Useful References

• US State Codes Reference
• Transfers API Integration