# FAQs ### Getting Started #### How do I get access to the Minit Money Enterprise API? To get started, you'll need API credentials. Contact our team at [minitmoney.enterprises/about-us](https://minitmoney.enterprises/about-us) to request access. Once approved, you'll receive an API key that you can use to authenticate your requests via the `x-api-key` header. #### What authentication method does the API use? The API uses API Key authentication. Include your API key in the `x-api-key` header with every request. Each tenant receives a unique API key that identifies and authorizes their requests. #### Is there API documentation available? Yes! The API follows OpenAPI 3.1.0 specification. You can find the complete OpenAPI specification in the `openapi.json` file, which can be viewed in tools like Swagger UI or Postman. ### Transactions & Transfers #### How do I create a money transfer? Creating a transfer is a multi-step process: 1. Create a **sender** (if not already created) - `POST /api/v1/senders` 2. Create a **beneficiary** (recipient) - `POST /api/v1/beneficiaries` 3. Get a **quote** with locked exchange rate - `POST /api/v1/quotes` 4. Create a **transaction** using the quote - `POST /api/v1/transactions` 5. **Commit** the transaction to process it - `POST /api/v1/transactions/{transactionId}/commit` #### How long are quotes valid? Quotes are valid for 30 minutes from creation. The exchange rate and fees are locked during this period, protecting you from rate fluctuations. You must create and commit a transaction using the quote within this timeframe. #### What is the minimum transfer amount? The minimum transfer amount is $10 USD. Maximum amounts may vary depending on the corridor and payout method. #### How can I track transaction status? You can check transaction status in two ways: * **Polling**: Use `GET /api/v1/transactions/{transactionId}/status` to retrieve the current status * **Webhooks**: Subscribe to real-time status updates via `POST /webhooks/subscribe/{tenantId}` to receive notifications when status changes ### Corridors & Coverage #### What countries and currencies are supported? Use the Corridors API to discover available transfer routes: * `GET /api/v1/corridors` - List all available corridors with supported currency pairs * Each corridor shows source and destination countries, exchange rates, and fees #### What are payout methods? Payout methods define how money is delivered to beneficiaries (e.g., bank transfer, mobile money, cash pickup). Available methods vary by corridor. Use `GET /api/v1/corridors/{corridorId}/payout-methods` to see options for a specific route. #### How are fees calculated? Fees consist of two components: * **Percentage fee**: A percentage of the transfer amount * **Fixed fee**: A flat fee in the source currency Both are included in quote responses and visible in corridor details. ### Compliance & KYC #### What KYC information is required? Sender KYC requirements vary by corridor and transfer amount. Use the Sender KYC API to: * Upload KYC documents - `POST /api/v1/senders/{senderId}/kyc` * Check verification status - `GET /api/v1/senders/{senderId}/kyc` * Update verification status - `PUT /api/v1/senders/{senderId}/kyc/status` #### How long does KYC verification take? Verification times vary depending on the documents provided and the destination country's requirements. You can monitor KYC status via the KYC endpoints. ### Technical Questions #### What response format does the API use? All API responses are in JSON format. Successful responses return relevant data, while errors return a structured error object with `statusCode`, `message`, `errorCode`, and contextual `info`. #### Are there rate limits? Rate limiting policies may apply to ensure fair usage and system stability. Contact our support team for details about rate limits for your account. #### What happens if a webhook fails to deliver? Webhooks support configurable retry attempts. If delivery fails, the system will retry based on your webhook subscription configuration. You can set the number of retry attempts when subscribing. #### Which API version should I use? New integrations should use `/api/v1` endpoints. Legacy `/` (v0) endpoints are maintained for backward compatibility but may have limited features compared to v1. ### Support & Contact #### How do I get help or report issues? For support, questions, or to report issues, please visit our contact page at . Our team is ready to assist you with integration questions, technical issues, or account inquiries. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.minitmoney.enterprises/resources/faqs.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.