NuPayBT API Documentation for RMA Payment Gateway

const createPayment = async () => {
    try {
        const response = await fetch('/api/payment/create', {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json',
                'Accept': 'application/json'
            },
            body: JSON.stringify({
                api_key: 'rma_OKmXkjtDxP6ZIZI8V2sRUUDDUpdfkZPE',
                api_secret: 'ubEZf57F9jYaNDimP41BzPhCGPfQ73XDneaUHVja1U6WgKUI3YxamNZZSENPvChG',
                amount: 100.00,
                order_id: 'ORDER-2024-001',
                customer_email: 'customer@example.com',
                description: 'Payment for order ORDER-2024-001'
            })
        });
        
        const result = await response.json();
        
        if (result.success) {
            // Redirect customer to payment URL
            window.location.href = result.data.payment_url;
        } else {
            console.error('Payment failed:', result.message);
        }
    } catch (error) {
        console.error('Error:', error);
    }
};

<?php
function createRMAPayment($apiKey, $apiSecret, $amount, $orderId) {
    $url = 'http://127.0.0.1:8000/api/payment/create';
    
    $data = [
        'api_key' => $apiKey,
        'api_secret' => $apiSecret,
        'amount' => $amount,
        'order_id' => $orderId
    ];
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json',
        'Accept: application/json'
    ]);
    
    $response = curl_exec($ch);
    $result = json_decode($response, true);
    curl_close($ch);
    
    if ($result['success']) {
        // Redirect to payment URL
        header('Location: ' . $result['data']['payment_url']);
        exit;
    } else {
        echo 'Payment failed: ' . $result['message'];
    }
}

// Usage
createRMAPayment(
    'rma_OKmXkjtDxP6ZIZI8V2sRUUDDUpdfkZPE',
    'ubEZf57F9jYaNDimP41BzPhCGPfQ73XDneaUHVja1U6WgKUI3YxamNZZSENPvChG',
    100.00,
    'ORDER-2024-001'
);
?>

{
    "success": true,
    "message": "Payment created successfully",
    "data": {
        "transaction_id": "TXN_1758827100_123",
        "order_id": "ORDER-2024-001",
        "amount": 100.00,
        "currency": "BTN",
        "payment_url": "http://127.0.0.1:8000/payment/TXN_1758827100_123",
        "status": "initiated",
        "beneficiary": "Your Company Name",
        "bank_name": "Bhutan National Bank",
        "created_at": "2025-09-25T19:05:00.000000Z"
    }
}

Authorization: Bearer YOUR_API_KEY
X-API-Secret: YOUR_API_SECRET
Content-Type: application/json

curl -X POST https://bigtech.codes/api/payment/create \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "api_key": "rma_OKmXkjtDxP6ZIZI8V2sRUUDDUpdfkZPE",
    "api_secret": "ubEZf57F9jYaNDimP41BzPhCGPfQ73XDneaUHVja1U6WgKUI3YxamNZZSENPvChG",
    "amount": 100.00,
    "order_id": "ORDER_123",
    "customer_email": "customer@example.com",
    "description": "Payment for ORDER_123"
  }'

{
  "success": true,
  "payment_id": "pay_1234567890",
  "payment_url": "https://gateway.rmapayments.bt/pay/1234567890",
  "status": "pending",
  "amount": 100.00,
  "currency": "BTN",
  "order_id": "ORDER_123",
  "expires_at": "2024-01-01T12:30:00Z"
}

{
  "success": true,
  "payment_id": "pay_1234567890",
  "status": "completed",
  "amount": 100.00,
  "currency": "BTN",
  "order_id": "ORDER_123",
  "bank_code": "01",
  "transaction_id": "TXN_987654321",
  "completed_at": "2024-01-01T12:35:00Z"
}

// v2.0 Simple Configuration - Only 2 fields needed!
$settings = array(
    'enabled' => 'yes',
    'title' => 'RMA Payment Gateway',
    'use_v2_api' => 'yes',
    'api_key' => 'rma_OKmXkjtDxP6ZIZI8V2sRUUDDUpdfkZPE',
    'api_secret' => 'ubEZf57F9jYaNDimP41BzPhCGPfQ73XDneaUHVja1U6WgKUI3YxamNZZSENPvChG',
    'test_mode' => 'yes'
    // No beneficiary_id, bank_code, or private_key needed!
);

// v1.0 Legacy Configuration (for backward compatibility)
$settings = array(
    'enabled' => 'yes',
    'title' => 'RMA Payment Gateway',
    'use_v2_api' => 'no',
    'api_key' => 'your_api_key_here',
    'api_secret' => 'your_api_secret_here',
    'beneficiary_id' => 'BE10000255',
    'bank_code' => '01',
    'private_key' => 'your_private_key',
    'test_mode' => 'yes'
);

composer require rma/payment-gateway-php

<?php
require_once 'vendor/autoload.php';

use RMA\PaymentGateway\SimpleClient;

// Initialize Simple Client (only API key/secret needed)
$client = new SimpleClient([
    'api_key' => 'rma_OKmXkjtDxP6ZIZI8V2sRUUDDUpdfkZPE',
    'api_secret' => 'ubEZf57F9jYaNDimP41BzPhCGPfQ73XDneaUHVja1U6WgKUI3YxamNZZSENPvChG',
    'test_mode' => true
]);

// Create payment (auto-configured)
$payment = $client->createPayment([
    'amount' => 150.00,
    'order_id' => 'ORDER_123',
    'customer_email' => 'customer@example.com',
    'description' => 'Payment for ORDER_123'
]);

// Redirect to payment
header('Location: ' . $payment['payment_url']);
?>

<?php
// Legacy Client (requires manual configuration)
use RMA\PaymentGateway\Client;

$client = new Client([
    'api_key' => 'your_api_key',
    'api_secret' => 'your_api_secret',
    'beneficiary_id' => 'BE10000255',
    'bank_code' => '01',
    'test_mode' => true
]);

$payment = $client->payments()->create([
    'amount' => 150.00,
    'currency' => 'BTN',
    'order_id' => 'ORDER_123',
    'customer' => [
        'email' => 'customer@example.com',
        'phone' => '17123456'
    ]
]);
?>

<script src="/downloads/javascript-sdk/src/SimpleRMAGateway.js"></script>

// Initialize Simple SDK (only API key/secret needed)
const rma = new SimpleRMAGateway({
    apiKey: 'rma_OKmXkjtDxP6ZIZI8V2sRUUDDUpdfkZPE',
    apiSecret: 'ubEZf57F9jYaNDimP41BzPhCGPfQ73XDneaUHVja1U6WgKUI3YxamNZZSENPvChG',
    testMode: true
});

// Create payment (auto-configured)
async function processPayment() {
    try {
        const payment = await rma.createPayment({
            amount: 200.00,
            orderId: 'ORDER_' + Date.now(),
            customerEmail: 'customer@example.com',
            description: 'Payment for order'
        });
        
        // Redirect to payment URL
        window.location.href = payment.payment_url;
        
    } catch (error) {
        console.error('Payment failed:', error);
    }
}

// Or create and redirect in one step
async function createAndRedirect() {
    await rma.createPaymentAndRedirect({
        amount: 200.00,
        orderId: 'ORDER_' + Date.now(),
        customerEmail: 'customer@example.com'
    });
}

// Event listeners
rma.on('payment.created', function(payment) {
    console.log('Payment created:', payment);
});

rma.on('payment.error', function(error) {
    alert('Payment failed: ' + error.message);
});

curl -X POST https://bigtech.codes/api/payment/create \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "api_key": "rma_OKmXkjtDxP6ZIZI8V2sRUUDDUpdfkZPE",
    "api_secret": "ubEZf57F9jYaNDimP41BzPhCGPfQ73XDneaUHVja1U6WgKUI3YxamNZZSENPvChG",
    "amount": 300.00,
    "order_id": "DIRECT_123456",
    "customer_email": "customer@example.com",
    "description": "Direct API integration payment"
  }'

function createDirectPayment($apiKey, $apiSecret, $amount, $orderId) {
    $url = 'https://bigtech.codes/api/payment/create';
    
    $data = [
        'api_key' => $apiKey,
        'api_secret' => $apiSecret,
        'amount' => $amount,
        'order_id' => $orderId,
        'customer_email' => 'customer@example.com',
        'description' => 'Direct integration payment'
    ];
    
    $options = [
        'http' => [
            'method' => 'POST',
            'header' => [
                'Content-Type: application/json',
                'Accept: application/json'
            ],
            'content' => json_encode($data)
        ]
    ];
    
    $context = stream_context_create($options);
    $response = file_get_contents($url, false, $context);
    $result = json_decode($response, true);
    
    if ($result['success']) {
        // Redirect to payment URL
        header('Location: ' . $result['data']['payment_url']);
        exit;
    } else {
        echo 'Payment failed: ' . $result['message'];
    }
}

const crypto = require('crypto');
const axios = require('axios');

class RMAGateway {
    constructor(config) {
        this.apiKey = config.apiKey;
        this.apiSecret = config.apiSecret;
        this.beneficiaryId = config.beneficiaryId;
        this.bankCode = config.bankCode;
        this.privateKey = config.privateKey;
    }

    generateChecksum(data) {
        const sourceString = Object.values(data).join('|');
        const sign = crypto.createSign('RSA-SHA256');
        sign.update(sourceString);
        return sign.sign(this.privateKey, 'hex');
    }

    async createPayment(paymentData) {
        const data = {
            bank_code: this.bankCode,
            beneficiary_id: this.beneficiaryId,
            timestamp: new Date().toISOString().replace(/[-:T.]/g, '').slice(0, 14),
            message_type: 'AR',
            order_id: paymentData.orderId,
            description: paymentData.description,
            customer_email: paymentData.customerEmail,
            amount: paymentData.amount.toFixed(2),
            currency: 'BTN',
            version: '1.0'
        };

        const checksum = this.generateChecksum(data);
        
        return await axios.post('/api/payments', {
            ...data,
            checksum
        }, {
            headers: {
                'Authorization': `Bearer ${this.apiKey}`,
                'X-API-Secret': this.apiSecret
            }
        });
    }
}