# API Sequence

[block:image] { "images": [ { "image": [ "https://files.readme.io/5b86eee2da1fb8ada39d20fc91150605ba664fad3137da627c83d1e43f06109a-cash-in-from-mini-app-api-sequence.png", "", "" ], "align": "center", "sizing": "90% " } ] } [/block]

This solution requires the Customer Access Token (`accessToken`), which you will obtain during session initiation as part of the full implementation of the Maya Mini App. For more details, please refer to the **Maya Mini App** guide.

1. The customer initiates a Cash-in to their Maya wallet through the API Consumer using a web view within the Maya App. 2. The API Consumer prepares the valid token. Refer to the **Maya Mini App** for more details. 3. The API Consumer calls the **Initiate a Transfer** endpoint of Maya Cash-in using the **Customer Access Token** (`accessToken`) in Maya. 4. Maya Cash-in creates the transfer intent in Maya, uniquely identified by a `transferId`. 5. Maya Cash-in responds to the API Consumer with the generated transferId in Maya. 6. The API Consumer saves the `transferId` acquired from Maya. 7. The API Consumer calls the **Execute Transfer** endpoint of Maya, providing the `transferId` associated with the transfer intent in Maya. 8. Maya Cash-in processes the transfer intent in Maya. 9. If successful or failed, Maya Cash-in responds with the result. 10. If the API Consumer receives an **ambiguous error** or no response from Maya Cash-in: * API Consumer calls the **Retrieve a Transfer** endpoint of Maya providing the `transferId` in Maya. * Maya Cash-in returns the details of the transfer intent associated with the `transferId` in Maya. 11. The API Consumer notifies the customer of the status.

## Create the required pages

Design and host your mini app or webview pages.

Based on your envisioned customer journey, design and create a button within your page for your customers to initiate the Cash-in transaction.

## Initiate and execute a Cash-in transaction

Use customer `accessToken` from the Maya Mini App to initiate and execute a Cash-in to Maya wallet.

When implementing **Maya Mini App**, your Mini App shall be able to utilize the **Customer Access Token** or the `accessToken` obtained from Maya through your **session URL** or acquired by **refreshing the tokens** , whichever is the most recent or valid value. Once your application has acquired the Customer Access Token (`accessToken`) from Maya, you may proceed with the following steps. *** ### Step 1: Initiate Transfer

Any requests using an expired Customer Access Token (`accessToken`) will result in an **error**. Be sure to use a **valid** `accessToken` and request a **new** `accessToken` as needed. Refer to the **Manage Mini App Session: Expired Customer Session** for the handling of expired `accessToken`.

Initiate the Cash-in by calling the **Initiate a Transfer** endpoint of Maya. Each transfer attempt creates a **new intent** and is assigned a unique `transferId` in Maya. Maya recommends generating a unique request reference number for each transfer. Note that Maya's `transferId` will be used to ensure the idempotency of the transfer intent during execution.

At present, there is **no time restriction** for executing a transfer intent after it has been created. However, if you choose not to proceed, you can discard the `transferId` and handle the customer management on your end. **NOTE**: *Change in this behavior may be imposed in the future.*

At this stage, **no funds are moved** within Maya. This provides you ample time to validate transfer details, including recipient information, potential fees, and other relevant factors. [block:tutorial-tile] { "backgroundColor": "#018FF4", "emoji": "📖", "id": "6a6196383c739db831fe2c75", "link": "https://developers.maya.ph/v6.00/recipes/initiate-cash-in-using-maya-mini-apps-token", "slug": "initiate-cash-in-using-maya-mini-apps-token", "title": "Initiate Cash-in using Maya Mini Apps Token" } [/block] *** ### Step 2: Execute Transfer After creating the intent to transfer in Maya, proceed by calling the **Execute Transfer** endpoint of Maya with the provided `transferId`. Triggering the Execute Transfer of Maya finalizes the request and authorizes the balance movement in Maya.

Execution of a particular transfer in Maya can only be done **ONCE**. Whether `APPROVED` or `DECLINED`, succeeding execution in Maya will return an error.

At this stage, **funds are moved** from your account in Maya to the customer’s Maya wallet. [block:tutorial-tile] { "backgroundColor": "#018FF4", "emoji": "📖", "id": "6a6196383c739db831fe2c76", "link": "https://developers.maya.ph/v6.00/recipes/execute-a-transfer-intent", "slug": "execute-a-transfer-intent", "title": "Execute a Transfer Intent" } [/block]

## Monitor the Cash-in transaction

Monitoring the Cash-in transaction in Maya.

### As a Cash-in partner Maya's Cash-In solution does not support webhooks. Instead, the cash-in endpoint handles the transaction synchronously, and the final status is returned directly in the response. In cases where a timeout or an [**uncertain error**](https://developers.maya.ph/reference/business-rules-to-code-for-cash-in#handling-of-ambiguous-errors-in-cash-in-to-maya-wallet) occurs, you can verify the transaction status by calling Maya’s [**Retrieve a Transfer**](https://developers.maya.ph/reference/retrieveusingget_1) endpoint using the `transferId`. This allows you to confirm whether the transaction was successfully processed. #### Refer to the Code Recipe below to guide you in building the request: [block:tutorial-tile] { "backgroundColor": "#018FF4", "emoji": "📖", "id": "6a6196383c739db831fe2c77", "link": "https://developers.maya.ph/v6.00/recipes/retrieve-a-transfer-intent", "slug": "retrieve-a-transfer-intent", "title": "Retrieve a Transfer Intent" } [/block] *** ### As a Maya Wallet user Customers will be notified via SMS from Maya or the Maya mobile app notification. They can view the Cash-in transaction in the **Transaction List within the Maya App**.