In this section, you’ll learn how to create a new Wallet using the Bila GraphQL API. Creating a Wallet is the first step in integrating users into the Bila platform.

​

Mutation

To create a new Wallet, use the createWallet mutation. Below is the syntax and a detailed example of how to use this mutation.

​

Syntax

mutation CreateWallet($input: CreateWalletInput!) {
  createWallet(input: $input) {
    Wallet {
      id
      balance
    }
  }
}

​

Input Fields

• userId (String!): The id of the Wallets holder.

​

Example Request

mutation {
  createWallet(input: { userId: "1" }) {
    Wallet {
      id
      balance
    }
  }
}

​

Example Response

{
  "data": {
    "createWallet": {
      "Wallet": {
        "id": "1",
        "balance": 200
      }
    }
  }
}

​

Handling Errors

When creating an Wallets, you may encounter various errors. Below are some common errors and how to handle them:

• Invalid input: This error occurs if the input data does not meet the required format or constraints. Verify that all required fields are provided and correctly formatted.

​

Example Error Response

{
  "errors": [
    {
      "message": "Invalid input",
      "locations": [
        {
          "line": 2,
          "column": 3
        }
      ],
      "path": ["createWallet"]
    }
  ],
  "data": {
    "createWallet": null
  }
}

​

Best Practices

• Validate input data: Always validate input data on the client side before sending the request to ensure it meets the API requirements.
• Handle errors gracefully: Implement error handling in your application to provide meaningful feedback to the user.
• Secure sensitive information: Ensure that sensitive information, such as passwords, is transmitted securely using HTTPS and is properly hashed and stored.

​

Conclusion

Creating a Wallet is a fundamental operation in the Bila ecosystem. By following the guidelines and examples provided, you can easily integrate Wallet creation into your application.

For further assistance or more detailed information, refer to the API Reference or contact our support team.

Continue exploring the Bila API documentation to learn about other operations you can perform.