Skip to main content

​
Introduction

This feature is designed for merchants who send international (IRT) transfers. It lets them manage their recipients.

​
Recipient management

A recipient is a person who receives funds from an international transfer, via mobile money or bank transfer. Available actions:
  • Creation: add a new recipient.
  • Retrieval: view a list of recipients or a specific recipient.
  • Deletion: remove a recipient.
For complete details, refer to the API reference.

​
Account verification

When a recipient is created, HUB2 checks that their account exists, based on:
  • the phone number (msisdn) for mobile money;
  • the IBAN (iban) for bank transfers.
The first and last names provided must match the account holder’s names, otherwise the creation is rejected with a 400 Bad Request error. Once the account is verified, its KYC (Know Your Customer) information is stored with the recipient, so that funds are sent to the intended person.
HUB2 also provides an endpoint to retrieve KYC information. See: KYC endpoint.

​
Next steps

Each registered recipient is assigned a unique identifier. Use this identifier to initiate IRT transfers with the following endpoint: Make an IRT transfer to a verified recipient