Skip to main content

Getting Started

This document aims to show you how to quickly use MixPay for receiving payments, and outlines some considerations and implementation scenarios.

Using MixPay​

Assuming you are now preparing to sell coffee, with each cup priced at 5 dollars. Clicking the MixPay payment link below will allow you to quickly experience the convenience of MixPay's payment process.

https://mixpay.me/pay?payeeId=a0d7791408776b47eb1dd3f94ed15d6a&quoteAssetId=usd&quoteAmount=5

info

In the link above, the payeeId represents the payee as MixPay, which you can replace with your own. Additionally, you can change the quoteAmount in the link. Please note that this is just an example, and as you can see, you can freely change the quoteAmount. Therefore, this is not the best practice for MixPay.

I believe that through the link above, you have experienced how excellent MixPay is. In addition to the most basic on-chain payments, we also support more than ten mainstream wallet apps as convenient payment methods.

MixPay Payment flow​

To get started, let's have a bird's eyes view of the MixPay Payment flow:

  1. The customer confirms the order details.
  2. The merchant creates orders and asks customers to pay (The checkout page).
  3. MixPay is waiting for payment.
  4. The merchant queries payment results and shows the result to the customer.

Account​

At present, MixPay offers five methods to create an account. You can register an account on MixPay's Dashboard at any time.

  • Mixin account - Register a Mixin account using your phone number, and then log in by scanning the QR code. Suitable for personal receiving payments.
  • MetaMask Acount - Log in using MetaMask wallet authorization. Suitable for personal receiving payments.
  • Email Account - Register and log in using email verification code. Suitable for corporate users, with permission functions under development...
  • Multi-Signature account - This is suitable for if multiple people own your store. Please refer to those articles:
  • Mixin Robot account - Mixin's Messenger Bot it's programmable. More suitable for businesses with higher customization requirements.

If you don't know how to choose, you can go with the "User account", or contact our customer service.

Payee ID​

payeeId is the account's UUID. This UUID is very important and determines the destination of the money received.

There are three ways of getting the payee's UUID:

  • You can use this bot (7000101422) to get the Mixin User/Robot UUID, send the Mixin ID in the chat window to the bot, and it will reply with the corresponding UUID. It's simple, and no programming is required.

  • Also, if the user UUID you want to acquire is a MixPay user, you can quickly get this UUID via Get Mixin UUID API.

Where to view all the transactions?​

You can check your transaction history in MixPay's Payment History on the Dashboard.

Where does the money go?​

After customers make payments via MixPay, the settlement will go to different destinations based on the account.

  • Mixin account - In your Mixin Wallet
  • MetaMask Acount - In MetaMask Wallet
  • Email Account - In MixPay Account Wallet
  • Multi-Signature account - In Multi-Signature Wallet. For more details, please refer to the official Mixin API documentation.
  • Mixin Robot account - In your Mixin Robot Wallet. For more details, please refer to the official Mixin API documentation.

Integrating MixPay​

The following are the basic steps for integrating MixPay:

  1. Create a MixPay account for receiving payments.

    • For details on account types and specific instructions, please refer to this link.

  2. Use MixPay's API to create a payment link for customers to make payments.

    • Determine your quote currency and amount, such as 10 dollars. For more options, see here.
    • Choose your desired receiving currency; you can choose to receive 10 dollars in USDT or 10 dollars in BTC, whichever you prefer. For more options, see here.
    • Enter your callback URL to receive the user's payment results.

  3. Checking the payment results is extremely important, and you need to be very cautious.

    • Be sure to follow the steps in this tutorial.
    • If it is not convenient to use a callback URL during testing, we recommend using postbin.

Furthermore, we offer ready-to-use payment solutions for a variety of use cases:

Ideal situations for utilizing MixPay​

MixPay Protocol​