Base URL: https://your-domain.com/api
All endpoints on this page require Authorization: Bearer {token}.
Flow overview
Validate the recipient
Call POST /send-money-email-check or POST /send-money-phone-check to confirm the recipient exists and is active.
Select currency
Call GET /get-send-money-currencies to list the sender’s eligible wallets.
Check fees and limits
Call POST /check-send-money-amount-limit with the chosen currency and amount to get fee details.
Execute the transfer
Call POST /send-money-pay with the confirmed values.
POST /send-money-email-check
Validates that a recipient email is eligible to receive a transfer.
Request parameters
The authenticated sender’s ID.
The recipient’s email address.
Response fields
200 on success, 401 on validation failure.
Error reason: own-email, suspended, or inactive.
Human-readable error description.
curl --request POST \
--url https://your-domain.com/api/send-money-email-check \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data '{"user_id": 42, "receiverEmail": "[email protected]"}'
POST /send-money-phone-check
Validates that a recipient phone number is eligible to receive a transfer.
Request parameters
The authenticated sender’s ID. The sender must have a phone number set.
The recipient’s formatted phone number (international format).
Response fields
200 on success, 401 on failure, 404 if sender has no phone set.
Error reason: own-phone, suspended, or inactive.
Human-readable error description.
curl --request POST \
--url https://your-domain.com/api/send-money-phone-check \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data '{"user_id": 42, "receiverPhone": "+11234567890"}'
GET /get-send-money-currencies
Returns the currencies available for the sender to use, filtered to wallets that have active fee/limit rules.
Request parameters
The authenticated user’s ID.
Response fields
Key-value map of currency_id to currency info.
Yes if this is the user’s default wallet currency.
curl --request GET \
--url 'https://your-domain.com/api/get-send-money-currencies?user_id=42' \
--header 'Authorization: Bearer {token}'
POST /check-send-money-amount-limit
Validates the transfer amount against fees and limits, and returns the fee breakdown.
Request parameters
The authenticated sender’s ID.
The currency ID to send in.
Response fields
200 on success, 401 on limit/balance failure.
Failure reason: insufficientBalance, minLimit, or minMaxLimit.
The requested send amount.
The selected currency ID.
Total fees (fixed + percentage).
Formatted total amount including fees.
Minimum allowed amount (on limit error).
Maximum allowed amount (on limit error).
curl --request POST \
--url https://your-domain.com/api/check-send-money-amount-limit \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data '{"user_id": 42, "sendCurrency": 1, "sendAmount": 100}'
POST /send-money-pay
Executes the transfer. Both registered and unregistered recipients (by email or phone) are supported.
Request parameters
The authenticated sender’s ID.
Recipient’s email address or phone number.
Currency ID for the transfer.
Transfer amount (before fees).
Total fees from /check-send-money-amount-limit.
Optional note to the recipient.
Response fields
true if the transaction was created, false on hard failure.
The transaction or transfer record ID. Use with /get-user-specific-details to display recipient info.
sendMoneyValidationErrorMessage
Validation error message when status is false.
sendMoneyMailErrorMessage
Email notification error message when status is true but notification failed.
curl --request POST \
--url https://your-domain.com/api/send-money-pay \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data '{
"user_id": 42,
"emailOrPhone": "[email protected]",
"currency_id": 1,
"amount": 100,
"totalFees": 1.50,
"note": "Lunch"
}'
