UnknownPay Payment Integration

Secure, mobile-first payment solutions with both direct API and SDK integration options.

🌐 Visit Our Website

For comprehensive documentation, integration guides, and to get started with UnknownPay, visit our official website:
https://unknownpay.sajib.xyz

🔑 Features

• Dual Integration: Choose between direct API or SDK
• Mobile Optimized: Built for bKash-style flows
• End-to-End Encryption: Secure OTP and PIN verification
• Real-Time Validation: Instant payment status updates
• Comprehensive Docs: Clear examples for all use cases

📦 Installation Options

Option 1: Official SDK

npm install unknownpay-sdk
# or
yarn add unknownpay-sdk

🛠️ SDK Usage

🔹 Initialization

import { createPayment, validatePayment } from 'unknownpay-sdk';

1. Create Payment

router.post('/create-payment', async (req, res) => {
try {
const payment = await createPayment(
SECRET_KEY,
{
amount: 150,
options_1: "ORDER-1001",
options_2: "[email protected]",
callback: "https://yourdomain.com/api/payment/callback",
tran_id: "txn-ABC123456"
}
);

    // Respond with payment URL and details
    res.status(200).json(payment);

} catch (error) {
console.error('Create Payment Error:', error.message);
res.status(500).json({ error: error.message });
}
});

2. Payment Callback Handler

router.post('/payment-callback', async (req, res) => {
try {
const { id: paymentId } = req.query;

    const result = await validatePayment(SECRET_KEY, paymentId);

    if (result.status === 'completed') {

// ✅ Update your database or order status here
return res.redirect(
`https://yourdomain.com/success?paymentID=${result.tran_id}&number=${result.number}&amount=${result.amount}`
);
} else {
return res.redirect(`https://yourdomain.com/error?message=${result.message}`);
}
} catch (error) {
console.log(error)
return res.status(500).json({
message:"Internal Server Error"
})
}
});

Option 2: Direct API Integration

No installation required - make direct HTTP requests. Main URL

https://secure.unknownpay.sajib.xyz/api/v1/payment

🌍 Payment Create

const createPayment = async () => {
  try {
    const response = await axios.post(
      'https://secure.unknownpay.sajib.xyz/api/v1/payment/create',
      {
        amount: 150,
        options_1: "ORDER-1001",
        options_2: "[email protected]",
        callback: "https://yourdomain.com/api/payment/callback",
        tran_id: "txn-ABC123456"
      },
      {
        headers: {
          'Content-Type': 'application/json',
          'secret': 'your-merchant-secret-key'
        }
      }
    );

    return response.data;
  } catch (error) {
    console.error('Payment creation failed:', error.response?.data || error.message);
  }
};

Headers:

{
    'Content-Type': 'application/json',
    'secret': 'your-merchant-secret-key'
}

Request Body:

{
  "amount": 150,
  "options_1": "ORDER-1001",
  "options_2": "[email protected]",
  "callback": "https://yourdomain.com/callback",
  "tran_id": "txn-ABC123456"
}

Response:

{
  "url": "https://pay.unknownpay.sajib.xyz?hash=..."
}

CallBack Handle

after payment failed or sucess return body in callback request

app.post('/api/payment/callback', async (req, res) => {
  try {
    const { id } = req.body;

    const response = await axios.post(
      'https://secure.unknownpay.sajib.xyz/api/v1/payment/validate',
      { id, secret: 'your-merchant-secret-key' },
      { headers: { 'Content-Type': 'application/json' } }
    );

    const result = response.data;
  if (result.status === 'completed') {
// ✅ Update your database or order status here
      return res.redirect(
        `https://yourdomain.com/success?paymentID=${result.tran_id}&number=${result.number}&amount=${result.amount}`
      );
    } else {
      return res.redirect(`https://yourdomain.com/error?message=${result.message}`);
    }
  } catch (error) {
    console.log(error)
    return res.status(500).json({
      message:"Internal Server Error"
    })
  }
});

Headers:

{
    'Content-Type': 'application/json',
    'secret': 'your-merchant-secret-key'
}

Request Body:

{
  "id": "payment-id"
}

Response:

{
  "status": "completed",
  "number": "01XXXXXXXXX",
  "amount": 150,
  "tran_id": "txn-ABC123456",
  "options_1": "ORDER-1001",
  "options_2": "[email protected]"
}

🔄 Payment Flow Diagram

❓ Frequently Asked Questions

Q: How long are payment sessions valid?
A: 30 minutes from creation.

Q: Can I reuse transaction IDs?
A: No, each transaction ID must be unique.

Q: Is HTTPS required for callbacks?
A: Yes, for security all callbacks must use HTTPS.

Q: Where can I find the latest documentation? A: Visit our official website at unknownpay.sajib.xyz for the most up-to-date documentation and resources.

📞 Support

Need help with integration?

• Website: UnknownPay
• Email: [email protected]
• Slack: Join our developer workspace
• Issues: GitHub issue tracker

📄 License

License: MIT
© 2025 UnknownPay. All rights reserved. https://unknownpay.sajib.xyz