Create Mock Deposits

The POST spei/test/deposits method enables you to simulate deposits in Mexican pesos (MXN) into the CLABEs linked to your Juno testing account, allowing complete testing of the API features. A mock deposit automatically triggers the issuance of MXNB stablecoins, credited to your testing account balance. This endpoint is accessible exclusively in Juno's testing environments (stage).

The minimum deposit amount is 100 MXN. If you transfer a lower amount, the deposit is successful. Still, the Juno platform rejects it when it validates the amount to generate the MXNB issuance. In the production environment, when such rejection occurs, the service transfers the funds back to the origin account.

To simulate a deposit and increase your MXNB balance, send the following HTTP request with the specified body parameters:

POST https://stage.buildwithjuno.com/spei/test/deposits

Body Parameters

  • amount (string): The amount to be deposited in MXN. This value should be a positive number representing the monetary amount to be deposited into the given CLABE.
  • receiver_clabe (string): The 18-digit Juno CLABE that receives the funds. The CLABE must belong to the user calling the endpoint.
  • receiver_name (string): The business name registered in the account linked to the CLABE (stored in Deposit > Bank Transfer (SPEI) : Beneficiary).
  • sender_name (string): The business name registered in the account linked to the CLABE (stored in Deposit > Bank Transfer (SPEI) : Beneficiary).

Note: Both given names must match the business name registered in your account (beneficiary); otherwise, the deposit might fail. This restriction applies only to the mock deposits endpoint. In a production environment, third-party deposits are possible, and in the issuance flow, any deposit from any sender will trigger an issuance if directed to an AUTO_PAYMENT CLABE.

The following object exemplifies the required body parameters to include in the HTTP request for simulating a deposit to a Juno CLABE:

{
   "amount": "1300",
   "receiver_clabe": "710969123456324311",
   "receiver_name": "Acme",
   "sender_name": "Acme"
}

A successful mock deposit returns the object shown below:

{
    "success": true,
    "payload": {
        "amount": "1300",
        "tracking_code": "TESTSPEI674421739902441867",
        "tracking_key": "TESTSPEI674421739902441867",
        "sender_clabe": "",
        "sender_name": "Acme",
        "sender_curp": "",
        "receiver_clabe": "710969000000324311",
        "receiver_name": "Acme",
        "receiver_curp": "",
        "created_at": "2025-02-18T18:14:01"
    }
}

Verify your simulated deposit by retrieving your MXNB balance, which is the only reported balance. Send the following HTTP request:

GET https://stage.buildwithjuno.com/mint_platform/v1/balances

It returns the following JSON object:

{
    "success": true,
    "payload": {
        "balances": [
            {
                "asset": "mxnbj",
                "balance": 3780.00
            }
        ]
    }
}

You can also verify your transaction via the GET /transactions method. For further details, see the article List Transactions Made.