> For the complete documentation index, see [llms.txt](https://wally-3.gitbook.io/wally-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wally-3.gitbook.io/wally-docs/developers/help-center.md).

# Help Center

> Common questions and troubleshooting for the Wally platform.

***

## FAQs

### How does the escrow work?

Wally creates a **TrustlessWork smart contract** on Stellar/Soroban. Funds are locked in the contract and only released when the sender approves and the verified provider has completed the service. See [Blockchain & Escrow](https://wally-3.gitbook.io/wally-docs/technical/blockchain.md) for details.

### What categories are supported?

* **Education**: School tuition, university fees
* **Health**: Hospital bills, pharmacy, clinic visits
* **Food**: Groceries, supermarket purchases
* **Construction**: Building materials, contractor payments
* **Expenses**: General daily needs
* **Emergency**: Urgent transfers

### Is my money safe?

Yes. Wally is **non-custodial** — your secret key is encrypted with your PIN using AES-256-GCM and never leaves your device unencrypted. Even Wally cannot access or move your funds.

### What are the fees?

* **QuickSend**: 3% of the transfer amount
* **Remittance with escrow**: 2-3% (includes escrow fee)
* **Stellar network fees**: <$0.01 per transaction
* **Savings**: No fees for deposits/withdrawals

### How does savings yield work?

Deposited USDC is supplied to the **Blend Capital** lending pool on Stellar/Soroban. The pool generates variable APY (\~0.5-5%) based on utilization. You can withdraw at any time.

### Which countries are supported?

* 🇺🇸 **USA** (sender side)
* 🇲🇽 **Mexico** (recipient & providers)
* 🇨🇷 **Costa Rica** (recipient & providers)
* 🇳🇮 **Nicaragua** (recipient & providers)

### How do I cash out USDC?

Via **MoneyGram SEP-24** integration — convert USDC to local currency at MoneyGram locations. Alternatively, pay directly to verified providers without needing cash.

### Can I use Wally via WhatsApp?

Yes. Link your phone number and you can check balances, send USDC, and receive notifications directly in WhatsApp.

***

## Troubleshooting

### API Connection Issues

Ensure the backend is running on port 4000 and environment variables are correctly set in `apps/api/.env`. Check that `DATABASE_URL` points to a valid PostgreSQL instance.

### Stellar Transaction Failures

* Check that the account has enough XLM for transaction fees
* Verify the USDC trustline is established
* For Soroban operations, ensure the RPC endpoint is reachable

### PIN / Wallet Issues

* The PIN is used to encrypt/decrypt your secret key locally
* If you forget your PIN, you can import your wallet using your secret key
* Never share your secret key or PIN with anyone

### Blend Capital Errors

* Ensure the Blend pool contract ID is correct in environment variables
* Soroban transactions may need simulation before submission
* Check that the user has sufficient USDC balance for the deposit

***

## Support

For technical issues, check the [GitHub repository](https://github.com) or reach out to the development team.

**Website**: [wallypay.lat](https://www.wallypay.lat)
