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 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 https://minitmoney.enterprises/contact. Our team is ready to assist you with integration questions, technical issues, or account inquiries.