Skip to main content
This guide shows you how to create your first payment using the Yuno SDK in under 5 minutes. You’ll learn how to:
  • Set up and run the example project
  • Make a test payment using the SDK
The Yuno SDK integrates payment methods into your web app and processes payments securely.

Step 1: Install prerequisites

Before getting started, ensure you have the following installed on your system:
  • Git - Required for downloading the project. If you haven’t used Git before, follow the Git installation guide
  • Node.js - Required for running the project. If you haven’t used Node.js before, download it from the official Node.js website

Step 2: Download the project

Download the example project or clone the GitHub repository. The project contains Yuno’s Web SDK and a sample frontend implementation.
SDK Integration ExampleYuno provides a ready-to-use app built with the Web SDK. Explore this project to see how fast and easy it is to integrate with Yuno.

Step 3: Set up environment variables

To authenticate with the Yuno API, you need to configure your credentials in the project. Follow these steps:
  1. Open the .env file in the root folder
  2. Add the following environment variables with your credentials from the dashboard’s Developers section:
    • ACCOUNT_CODE(will display as account_id in the dashboard)
    • PUBLIC_API_KEY
    • PRIVATE_SECRET_KEY
  3. Save the file

Step 4: Run the project

Navigate to the project folder and install the required Node.js dependencies by running:
Then, run the project with the following command:
To access the running app, open your browser and go to:
(Note: This is a local development URL that will only work when running the demo app locally)

Step 5: Make your first payment

After accessing the running project in your browser, you’ll see a basic checkout page displaying the Card payment method configured in Set Up Your Account. To create your first successful payment:
  1. Select the Card payment option
  2. Enter the test card information provided below
  • Cardholder name: Harry Potter
  • Card Number: 4242 4242 4242 4242
  • Expiration Date: 09/29
  • CVV: 123

Step 6: View payment details in the Dashboard

  1. After submitting the payment, wait a few seconds for it to process
  2. Go to the Payments section in your dashboard
  3. Find your test payment in the list
  4. Click the eye icon to view the full payment details
Congratulations! You’ve successfully created your first payment with Yuno. Check out the Core Concepts guides to learn more about integrating additional features.