Create New Receiver

Create a new receiver under a SubAccount for receiving the payout.

Create a New Receiver

POST /api/receiver

Headers

Name	Value
x-api-key	<token>
signature	<token>

Body

Name	Type	Description
subaccount_id*	string	Subaccount ID of the receiver user.
first_name*	string	First Name of the receiver user.
last_name*	string	Last Name of the receiver the user.
middle_name	string	Middle Name of the receiver the user.
email*	string	Email of the receiver the user.
dob*	string	Date of Birth of the receiver the user.
dialcode*	string	Dial Code of the receiver the user.
phone*	string	Phone of the receiver the user.
address*	string	Address of the receiver the user.
address2	string	Address2 of the receiver the user.
gender	string	Gender of the receiver the user.
city*	string	City of the receiver the user.
state*	string	State of the receiver the user.
postcode*	string	Postcode of the receiver the user.
country*	string	Country of the receiver the user.
reference*	string	Reference of the receiver.

* is mandatory parameter

Example body request

{
    "subaccount_id": "3dc81811-8cdb-49c6-8f9e-9b25ea4544b7"
    "first_name": "David",
    "last_name": "Lahm",
    "middle_name": "Robert",
    "email":"[e-mail]",
    "dob": "1990-03-21",
    "dialcode": "61",
    "phone": "213094857",
    "address": "122 Grenfell St",
    "gender": "M",
    "city": "Adelaide",
    "state": "SA",
    "postcode": "5000",
    "country": "AUS",
    "reference": "david8740"
}

Response

200

{
    "message": "Receiver created successfully",
    "payload": {
        "receiver_id": "d81b714c-a082-431a-8935-d0c67ad22c2d",
        "first_name": "David",
        "last_name": "Lahm",
        "email": "[e-mail]"
    }
}

400

{
    "message": "There was an error while creating a receiver",
    "error": [
        {
            "code": "REVR201",
            "message": "Email already exist"
        }
    ]
}