Eppay Documentation

Getting Started

Sending Payments

1. 1

   Navigate to the Send Payment screen in the app.

2. 2

   Enter or paste the recipient's wallet address, or select from your saved addresses.

3. 3

   Select the network you wish to use for the transaction.

4. 4

   Enter the amount of USDT to send.

5. 5

   Review transaction details and confirm with your PIN or biometric authentication.

Receiving Payments

1. 1

   Tap the "Get Paid" button in the app.

2. 2

   Select the network you wish to receive payment on.

3. 3

   Enter the amount of USDT you wish to receive.

4. 4

   Tap "Generate QR Code" to create a payment request.

5. 5

   Share the QR code with the sender, who can scan it to initiate the payment.

6. 6

   You'll receive a notification when the payment is confirmed.

QR Code Payment Process

The QR code contains your payment details including your wallet address, network information, and requested amount. When scanned, it initiates the transaction process automatically.

Integration Overview

Eppay provides a simple API that allows developers to generate payment requests and process transactions. The integration process involves:

Payment Flow

The payment process follows these steps:

1. 1

   Your application sends a request to the Eppay API to create a payment, specifying the amount, receiving wallet, network, and callback URL.

2. 2

   The API returns a unique paymentId that identifies this payment request.

3. 3

   Your application converts this paymentId into a QR code and displays it to the user.

4. 4

   The user scans the QR code with their Eppay mobile app or compatible crypto wallet to initiate the payment.

5. 5

   Once the payment is confirmed on the blockchain, Eppay notifies your application via the callback URL.

Generate Code

Request Parameters

Request Example

{
    "apiKey": "WlJSciIhgHkUzduirHj2AqIwxFvVGN",
    "amount": "1",
    "to": "0x8AB960B95aCCc5080c15721fdeA30e72C8251F0b",
    "rpc": "https://chain.scimatic.net",
    "token": "0x65C4A0dA0416d1262DbC04BeE524c804205B92e8",
    "success": "https://eppay.io/payment-success"
}

Response

{
    "paymentId": "8a020135-19b7-42df-be4b-1a8722ad0570"
}

Check Payment Status

Request Headers

Response Example (Success)

{
    "status": true,
    "message": "Payment completed successfully",
    "transaction": {
        "hash": "0x1a2b3c4d5e6f...",
        "timestamp": "2024-03-22T14:30:00Z",
        "amount": "1",
        "network": "Scimatic"
    }
}

Callback Response

When a payment is completed, Eppay sends a POST request to the callback URL specified in the initial request.

{
    "success": "success",
    "message": "Payment updated successfully",
    "transaction": {
        "paymentId": "8a020135-19b7-42df-be4b-1a8722ad0570",
        "hash": "0x1a2b3c4d5e6f...",
        "timestamp": "2024-03-22T14:30:00Z",
        "amount": "1",
        "network": "Scimatic"
    }
}

JavaScript Example

const apiUrl = 'https://eppay.io/generate-code';
const data = {
    apiKey: "WlJSciIhgHkUzduirHj2AqIwxFvVGN",
    amount: "1",
    to: "0x8AB960B95aCCc5080c15721fdeA30e72C8251F0b",
    rpc: "https://chain.scimatic.net",
    token: "0x65C4A0dA0416d1262DbC04BeE524c804205B92e8",
    success: "https://eppay.io/payment-success"
};

fetch(apiUrl, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => {
    console.log('Payment ID:', data.paymentId);
    // Generate QR code with: "product=uuideppay&id=" + data.paymentId
    // Display QR code to user
})
.catch(error => console.error('Error:', error));

PHP Example

$apiUrl = 'https://eppay.io/generate-code';
$data = [
    "apiKey" => "WlJSciIhgHkUzduirHj2AqIwxFvVGN",
    "amount" => "1",
    "to" => "0x8AB960B95aCCc5080c15721fdeA30e72C8251F0b",
    "rpc" => "https://chain.scimatic.net",
    "token" => "0x65C4A0dA0416d1262DbC04BeE524c804205B92e8",
    "success" => "https://eppay.io/payment-success"
];
$options = [
    'http' => [
        'header'  => "Content-Type: application/json\r\n",
        'method'  => 'POST',
        'content' => json_encode($data),
    ],
];
$context  = stream_context_create($options);
$response = file_get_contents($apiUrl, false, $context);
$result = json_decode($response, true);

echo "Payment ID: " . $result['paymentId'];
// Generate QR code with: "product=uuideppay&id=" . $result['paymentId']
// Display QR code to user

Python Example

import requests
import json

api_url = 'https://eppay.io/generate-code'
data = {
    "apiKey": "WlJSciIhgHkUzduirHj2AqIwxFvVGN",
    "amount": "1",
    "to": "0x8AB960B95aCCc5080c15721fdeA30e72C8251F0b",
    "rpc": "https://chain.scimatic.net",
    "token": "0x65C4A0dA0416d1262DbC04BeE524c804205B92e8",
    "success": "https://eppay.io/payment-success"
}

response = requests.post(api_url, json=data)
if response.status_code == 200:
    payment_id = response.json().get('paymentId')
    print('Payment ID:', payment_id)
    # Generate QR code with: "product=uuideppay&id=" + payment_id
    # Display QR code to user
else:
    print('Error:', response.json())

QR Code Generation Example

// Using qrcode.js library
// First include the library in your HTML
// 

function generateQRCode(paymentId) {
    const qrCodeData = `product=uuideppay&id=${paymentId}`;
    
    // Clear previous QR code if any
    document.getElementById('qrcode').innerHTML = '';
    
    // Generate new QR code
    new QRCode(document.getElementById('qrcode'), {
        text: qrCodeData,
        width: 256,
        height: 256,
        colorDark: '#000000',
        colorLight: '#ffffff',
        correctLevel: QRCode.CorrectLevel.H
    });
}