Send Naira to Monei User
monei_send_naira_to_userSend NGN to another Monei user using their email or phone number. Provide the amount, recipient, and 4-6 digit transaction PIN after confirming sufficient wallet balance.
Instructions
Sends NGN to another Monei user identified by their email address or phone number.
This is faster than a bank transfer and works instantly between Monei users. Use this when the recipient is identified by email or phone rather than a bank account number.
Before calling:
Confirm sufficient NGN balance using monei_get_wallet
Ask for the user's transaction PIN if not provided — never store or log it
Args:
amount (number): Amount in NGN to send (e.g. 5000 for ₦5,000)
receiver (string): Recipient's registered Monei email or phone number (e.g. "john@gmail.com" or "08012345678")
transactionPin (string): User's 4-6 digit transaction PIN — ask for this at runtime
Returns: { "reference": string, "status": string, "amount": number, "currency": "NGN", "receiver": string, "createdAt": string }
Examples:
"Send ₦5,000 to john@gmail.com" -> receiver: "john@gmail.com"
"Transfer 2000 naira to 08012345678" -> receiver: "08012345678"
Error handling:
Returns error if the receiver is not a registered Monei user
Returns error if insufficient balance
Security: Never log or store the transactionPin. Pass it directly to this call only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Amount in NGN to send (e.g. 5000 for ₦5,000) | |
| receiver | Yes | The recipient's registered Monei email address or phone number (e.g. john@gmail.com or 08012345678) | |
| transactionPin | Yes | User transaction PIN (4-6 digits). Required for all money movement operations. Prompt the user for this if not provided — never store or log it. |