Example Server Integration Guide

Overview

This guide helps you set up a backend server using our example code to integrate with KryptoGO payment APIs. This approach is ideal if you don’t already have your own server infrastructure or want a quick way to get started.

Before proceeding, make sure you have obtained your API key from KryptoGO Studio. If you haven’t done this yet, please refer to the Getting Started Guide.

Integration Workflow

Create Backend Server - Set up a secure backend using our example code
Configure Environment - Secure your API key using environment variables
Implement API Endpoints - Use the pre-configured endpoints that communicate with KryptoGO services
Test & Deploy - Test your implementation and deploy your server

Prerequisites

⚠️

Before setting up your server, you need:

Node.js installed on your development machine
Basic knowledge of Express.js framework
Your API key from KryptoGO Studio

Creating a New Express.js Project

You can quickly set up a backend server using Express.js to securely communicate with KryptoGO APIs. Here’s how to create a new project:

npx


# Create a new project using the KryptoGO Express template
npx create-kg-express-test my-app
cd my-app
 
# Copy example environment file and update with your credentials
cp .env.example .env
 
# Install dependencies
npm install
 
# Start the server
npm start

The npx template comes with pre-configured endpoints for KryptoGO API integration:

GET /api/payment/intents - Get all payment intents
POST /api/payment/intent - Create a payment intent
GET /api/payment/intent/:id - Get a specific payment intent
POST /api/asset_pro/transfer - Transfer assets or withdraw funds to external wallets

You can run tests with npm test or pnpm test

npm


# Create a new directory for your project
mkdir kg-backend
cd kg-backend
 
# Initialize a new Node.js project
npm init -y
 
# Install required dependencies
npm install express axios dotenv cors

yarn


# Create a new directory for your project
mkdir kg-backend
cd kg-backend
 
# Initialize a new Node.js project
yarn init -y
 
# Install required dependencies
yarn add express axios dotenv cors

pnpm


# Create a new directory for your project
mkdir kg-backend
cd kg-backend
 
# Initialize a new Node.js project
pnpm init -y
 
# Install required dependencies
pnpm add express axios dotenv cors

Configuring Environment Variables

Create a .env file in your project root directory to store your API key:


STUDIO_API_KEY=your_kryptogo_api_key_here
CLIENT_ID=your_client_id_here
ORIGIN=your_domain_here

⚠️

Make sure to add .env to your .gitignore file to prevent accidental exposure of your API key in version control.

Running Your Server

With your server implemented, you can now run it:

npm


npm start

yarn


yarn start

pnpm


pnpm start

Testing Your Implementation

You can test your implementation using tools like Postman or cURL:

curl


# Test health check endpoint
curl http://localhost:3001/
 
# List all payment intents
curl -H "X-STUDIO-API-KEY: YOUR_API_KEY" \
  -H "X-Client-ID: YOUR_CLIENT_ID" \
  -H "Origin: YOUR_DOMAIN" \
  http://localhost:3001/api/payment/intents
 
# Create a new payment intent
curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-STUDIO-API-KEY: YOUR_API_KEY" \
  -H "X-Client-ID: YOUR_CLIENT_ID" \
  -H "Origin: YOUR_DOMAIN" \
  -d '{"fiat_amount":"100.0","fiat_currency":"TWD","callback_url":"https://your-domain.com/webhook","order_data":{"order_id":"123"}}' \
  http://localhost:3001/api/payment/intent
 
# Get a specific payment intent
curl -H "X-STUDIO-API-KEY: YOUR_API_KEY" \
  -H "X-Client-ID: YOUR_CLIENT_ID" \
  -H "Origin: YOUR_DOMAIN" \
  http://localhost:3001/api/payment/intent/your_payment_intent_id
 
# Withdraw funds to external wallet
curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-STUDIO-API-KEY: YOUR_API_KEY" \
  http://localhost:3001/api/asset_pro/transfer \
  -d '{
    "chain_id": "arb",
    "contract_address": "0xff970a61a04b1ca14834a43f5de4533ebddb5cc8",
    "amount": "0.01",
    "wallet_address": "your_address"
  }'

Production Considerations

When deploying your backend to production:

Environment Variables: Ensure your API key is securely stored in environment variables
HTTPS: Use HTTPS for all communications
Rate Limiting: Implement rate limiting to prevent abuse
Error Handling: Enhance error handling for better debugging
Monitoring: Add monitoring and logging for production use
Authentication: Add proper authentication for your API endpoints

For production environments, consider using a service like Heroku, AWS, or Vercel that provides secure environment variable management.

Next Steps

After setting up your backend server:

Implement Frontend Integration: Connect your frontend application to your new API endpoints
Add Error Handling: Enhance error handling and user feedback
Implement Webhooks: Set up callback URLs for payment status updates
Test Thoroughly: Test all endpoints with various scenarios
Monitor Performance: Implement logging and monitoring

For detailed API documentation, please refer to our API Reference .