Skip to main content

Quick Start

Welcome to Mileston Payments Integration! 🎉 We’re thrilled to have you onboard! Integrating Mileston Payments is simple, fun, and opens your app to the world of crypto payments. Let’s dive in and create your first crypto payment link in just a few steps!

Quick Start: Create Your First Crypto Payment Link 🚀​

Step 1: Create an Account 📝​

Head over to business.mileston.co and sign up for your Mileston Business account.

This will give you access to our powerful dashboard where all the magic happens. ✨

Step 2: Get Your API Key 🔑​

Navigate to the Developers tab in the dashboard to generate your API key. You’ll find two types of keys:

  • Test API Key (for testnet, no real money involved):
    Mileston_TEST_hshshs7y373djdsdj...

  • Live API Key (for mainnet, real monetary value):
    Mileston_PROD_773hsiakakgddh...

⚠️ Pro Tip:
To generate the right key:

  • Switch to Test mode in the dashboard for the Test API key.
  • Switch to Live mode for the Live API key.

Step 3: Install the Backend SDK 🛠️​

Install our backend SDK to start creating payment links like a pro. Here's how:

npm install mileston-payments

Then, write some magic code like this:

import { PaymentLink } from 'mileston-payments';

const apiKey = 'your-api-key'; // Your API key
const businessId = 'your-business-id'; // Your business ID

// Initialize PaymentLink, Invoice, or RecurringPayment as needed
const paymentLink = new PaymentLink(apiKey, businessId);

// Generate a payment link
const link = await paymentLink.create({
  amount: 100, // Amount in your preferred currency
  currency: 'USD',
  description: 'Crypto Payment Example',
});
console.log('Payment link created:', link);

🔍 Where to find your businessId?
You can grab your Business ID from the dropdown menu under your business logo in the dashboard.

Step 4: Use the Payment Link in Your Frontend ✨​

Now that you’ve created a payment link, let’s add it to your frontend!

You can either:

  1. Build your own custom button, or
  2. Use our mileston-payment-client SDK for seamless integration.

First, install the client SDK:

npm install mileston-payment-client

Then, use our prebuilt payment button:

import { PayButton } from 'mileston-payment-client';

const App = () => (
  <PayButton
    paymentUrl="https://checkout.mileston.co/payment"
    onPaymentComplete={() => console.log('Payment complete!')}
    onPaymentDataReceived={(data) => console.log('Payment data received:', data)}
    onPaymentError={(error) => console.error('Payment error:', error)}
    style={{ backgroundColor: 'green', color: 'white' }}
  >
    Pay Now
  </PayButton>
);

👀 Why use the PayButton?
It handles everything: payment, verification, and an awesome user experience. You just sit back and sip coffee. ☕

Step 5: Keep API Keys Safe! 🛡️​

Important: Always use the backend SDK for API keys. Never expose your keys in the frontend, or you’ll have a bad time.

GitHub Repos 📂​

Check out our SDKs for more details and examples:

🎉 Congrats!
You’ve just created your first crypto payment link with Mileston Payments! High five! 🙌

What’s Next?​

Dive deeper into each tool and feature in the full documentation to unlock even more power.

Happy coding, and may your payments always succeed on the first try! 💪🔥