Cash PickUp

Fincra allows a recipient of a money transfer to retrieve their funds in cash from a physical location, rather than having them deposited electronically into a bank account.

Cash pickup is a fast, simple, convenient, secure, and affordable way of transferring money that allows individuals to send money to another person who can then pick up the cash in person from a designated location, such as a bank or a money transfer agent. The sender typically initiates the transaction online or through a mobile app and provides the necessary details, including the amount to be transferred and the recipient's name and location. The recipient then goes to the designated location with valid identification to collect the cash.
This service is commonly used for domestic and international money transfers and provides a convenient and secure way for individuals to send and receive cash.

Please Note
At the moment, the only available currency for this service is USD.
Also the Minimum amount required to use this service is $10 .

Field	Mandatory	Type	Description
business	Yes	String	The ID of the business making the payout.
sourceCurrency	Yes	String	The currency which is used to fund the payout
destinationCurrency	Yes	String	The currency in which the recipient will be receiving funds
amount	Yes	String	The value that is to be transferred from the source currency wallet.
paymentDestination	Yes	String	This is the type of account you want to send your payments to, see payment destinations for more details. e.g "cash_pick_up" for cash pick up.
sender	Yes	Object	The sender of the funds. Depending on the currency and beneficiary type, the properties of the beneficiaries are different.
sender.firstName	Yes	String	The first name of the sender.
sender.lastName	Yes	String	The last name of the sender.
sender.email	Yes	String	The email of the sender
sender.phone	Yes	String	The sender's phone number. Please Remove the country code and the leading zero from the number.
sender.birthDate	Yes	String	The birthdate of the sender. Sender's `birthDate` should be in this format: `YYYY-MM-DD`
sender.address	Yes	Object	The sender address Object
sender.address.country	Yes	String	The sender address Country. This field should be in ISO 3166-1 alpha-2 codes e.g NG, GB
sender.address.state	Yes	String	The state in the sender address. Input a 2-letter abbreviation of the sender's state. For example, TX, NY, WA. Non-US default: 01.
sender.address.postalCode	Yes	String	The sender's address postal code
sender.address.city	Yes	String	The sender's address city
sender.address.street	Yes	String	The sender's address street
beneficiary	Yes	Object	The recipient of the funds. Depending on the currency and beneficiary type, the properties of the beneficiaries are different.
beneficiary.firstName	Yes	String	The first name of the beneficiary.
beneficiary.middleName	Yes	String	The middle name of the beneficiary
beneficiary.lastName	Yes	String	The last name of the beneficiary
beneficiary.email	No	String	The beneficiary email address
beneficiary.type	Yes	String	The type of beneficiary, see beneficiary types for more details
beneficiary.phone	Yes	String	The beneficiary's phone number is significant as this is used to deliver the OTP code to receive payments at the bank. Please Remove the country code and the leading zero from the number.
beneficiary.address	Yes	Object	The beneficiary address object
beneficiary.address.country	Yes	String	The country in which the beneficiary address is located. This field should be in ISO 3166-1 alpha-2 codes e.g NG, GB
beneficiary.address.state	No	String	The state in the beneficiary address. Input a 2-letter abbreviation of the beneficiary's state. For example, TX, NY, and WA. Non-US default: 01.
beneficiary.address.city	No	String	The beneficiary's address city
beneficiary.address.street	No	String	The beneficiary's address street
beneficiary.cashPickUpLocationCode	Yes	String	This can be gotten by calling List bank endpoint on the country (NG) and check where `"isCashPickUp": true` e.g "NG_CP_LOC_1 "
beneficiary.securityQuestionId	No	String	This can be gotten by calling cash pickup security question endpoint
beneficiary.securityAnswer	No	String	This is an answer to be provided to the security question asked
description	Yes	String	A simple description of payment e.g "From Daniella"
quoteReference	Yes	String	This is the reference generated when the source currency is compared against the destination currency. This is required when the source currency is not the same as the destination currency. You can generate a quote using the Generate quote endpoint.

Make a POST request to create a payout endpoint passing the payload below.

{
    "business": "63da866cb938c4e0b871f514",
    "sourceCurrency": "EUR",
    "destinationCurrency": "USD",
    "amount": "10.00",
    "paymentDestination": "cash_pick_up",
    "sender": {
        "firstName": "Haishat",
        "lastName": "Technologies",
        "birthDate": "1997-10-21",
        "email": "h[email protected]",
        "phone": "09090909098",
        "address": {
            "country": "NG",
            "street" : "Mayor",
            "city": "Maoe",
            "postalCode": "234",
            "state": "LG"
        }
    },
    "beneficiary": {
        "firstName": "Ayo",
        "middleName": "Reciever",
        "lastName": "Technologies",
        "email": "[email protected]",
        "type": "individual",
        "phone": "090445023922",
        "address": {
            "state": "LG",
            "country": "NG",
            "street": "12, Maryland, Ikeja"
        },
        "cashPickUpLocationCode": "NG_CP_LOC_1",
        "securityQuestionId": 1,
        "securityAnswer": "Omolola Williams"
    },
    "description": "From Hai",
    "quoteReference": "7f491da7-44f0-4a33-aac6-0a3c7da4732a"
}

To get Cash Pickup Questions, make a GET request to cash pickup security question

Please Note

Ensure the beneficiary’s first, middle, and last name agrees to the beneficiary’s Government-issued ID
The beneficiary's phone number is significant as this is used to deliver the OTP code to receive payments at the bank.
The minimum payout amount for cash pick-up is 10USD