Website Connect Guide

1. Login করুন → Panel → Websites
2. Add Website → Shop/site name ও URL দিন (যেমন https://myshop.com)
3. Site API Key কপি করুন · এটাই আপনার সাইটের সিক্রেট কী
4. Panel → Gateways এ আপনার bKash/Nagad/Rocket নম্বর সেট করুন
5. Panel → APK থেকে Secret Connect Key নিয়ে ফোনে অ্যাপ Start করুন

Site API Key কখনো frontend/browser JS এ পাবলিক করবেন না · শুধু server-side / env তে রাখুন।

শুধু Key দিলে হবে না · Platform URL ছাড়া কোড জানে না কোন সার্ভারে request পাঠাবে। দুটোই দিন।

আপনার backend অথবা hosting env তে এগুলো রাখুন:

# .env  (Node / Next / Laravel / etc.)
PAYORA_PLATFORM_URL=http://217.216.38.82:3847
PAYORA_SITE_API_KEY=YOUR_SITE_API_KEY_FROM_PANEL

# Optional aliases some projects use:
# PAYORA_SITE_KEY=...
# PAYORA_API_URL=...

• Vercel / Netlify: Project Settings → Environment Variables
• cPanel / shared host: server config বা wp-config.php তে
• WordPress: wp-config.php বা secure options (client JS এ নয়)

1. কাস্টমার আপনার সাইটে প্রোডাক্ট/অ্যামাউন্ট সিলেক্ট করে
2. আপনার backend Payora BD API তে order create করে
3. Response এ checkout_url আসে → কাস্টমারকে সেখানে redirect
4. কাস্টমার bKash/Nagad/Rocket এ পেমেন্ট করে (আপনার নম্বরে)
5. ফোনের Auto Payment APK SMS/notification পড়ে TrxID মিলায়
6. Order status → PAID (সাধারণত ৫–১০ সেকেন্ড)
7. আপনার সাইট status poll করে সাকসেস পেজ দেখায়

Endpoint: POST http://217.216.38.82:3847/api/v1/checkout/create

POST http://217.216.38.82:3847/api/v1/checkout/create
Headers:
  Content-Type: application/json
  x-site-key: YOUR_SITE_API_KEY

Body (JSON):
{
  "amount": 500,
  "product_name": "UC Top Up",
  "method": "BKASH"
}

Methods: BKASH | NAGAD | ROCKET | BINANCE | REDOTPAY

Success response (example):
{
  "ok": true,
  "order_id": 123,
  "short_id": "Ab12Cd",
  "amount": 500,
  "checkout_url": "https://www.payorabd.com/pay/Ab12Cd",
  "gateway_url": "https://www.payorabd.com/pay/Ab12Cd"
}

→ Redirect customer to checkout_url

Buy / Checkout বাটনে ক্লিক করলে আপনার সার্ভার এই API কল করবে, তারপর কাস্টমারকে checkout_url এ পাঠাবে।

Checkout পেজ বা আপনার thank-you পেজ থেকে short_id দিয়ে status দেখুন:

GET http://217.216.38.82:3847/api/v1/checkout/order/SHORT_ID

Example response:
{
  "short_id": "Ab12Cd",
  "status": "pending" | "paid" | "failed",
  "amount": 500,
  "method": "BKASH",
  "trx_id": "..."
}

When status === "paid" → deliver product / mark WooCommerce order complete

সাধারণত প্রতি ২–৩ সেকেন্ডে poll করুন (checkout পেজে থাকাকালীন)। Webhook coming soon।

Site API Key কখনো থিম JS বা HTML এ লিখবেন না। Server-side (functions.php / custom plugin) থেকে API কল করুন।

Option A · Custom payment redirect (recommended pattern)

<?php
// wp-config.php
define('PAYORA_PLATFORM_URL', 'http://217.216.38.82:3847');
define('PAYORA_SITE_API_KEY', 'YOUR_SITE_API_KEY');

// functions.php or custom plugin  -  create Payora checkout & redirect
function payora_create_checkout($amount, $product_name, $method = 'BKASH') {
  $res = wp_remote_post(rtrim(PAYORA_PLATFORM_URL, '/') . '/api/v1/checkout/create', [
    'timeout' => 30,
    'headers' => [
      'Content-Type' => 'application/json',
      'x-site-key'   => PAYORA_SITE_API_KEY,
    ],
    'body' => wp_json_encode([
      'amount'       => (float) $amount,
      'product_name' => $product_name,
      'method'       => strtoupper($method),
    ]),
  ]);

  if (is_wp_error($res)) return null;
  $data = json_decode(wp_remote_retrieve_body($res), true);
  return !empty($data['checkout_url']) ? $data['checkout_url'] : null;
}

// Example: before customer pays, redirect to Payora checkout
add_action('template_redirect', function () {
  if (empty($_GET['payora_pay'])) return;
  $url = payora_create_checkout(299, 'Premium Package', 'BKASH');
  if ($url) {
    wp_redirect($url);
    exit;
  }
  wp_die('Payora checkout create failed');
});

Option B · After WooCommerce order (advanced)

WooCommerce native gateway হিসেবে প্লাগইন বানালে best। সিম্পল hook উদাহরণ (thankyou তে redirect করার আগে create করা ভালো):

// Create Payora link when customer chooses your custom gateway,
// then redirect to checkout_url instead of default payment.
// After Payora status=paid, mark WC order as processing/completed
// via cron or thank-you page that polls:
// GET /api/v1/checkout/order/{short_id}

ডেভেলপার না হলে: এই সেকশন + Platform URL + Site API Key ওয়ার্ডপ্রেস ডেভেলপারকে দিয়ে দিন।

// server-only (API route / backend)
const PLATFORM = process.env.PAYORA_PLATFORM_URL; // http://217.216.38.82:3847
const SITE_KEY = process.env.PAYORA_SITE_API_KEY;

export async function createPayoraCheckout({ amount, productName, method }) {
  const res = await fetch(`${PLATFORM}/api/v1/checkout/create`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-site-key": SITE_KEY,
    },
    body: JSON.stringify({
      amount,
      product_name: productName,
      method, // BKASH | NAGAD | ROCKET | BINANCE | REDOTPAY
    }),
  });
  const data = await res.json();
  if (!res.ok) throw new Error(data.message || data.error || "Checkout failed");
  return data; // { checkout_url, short_id, ... }
}

// Then: redirect user to data.checkout_url
// Poll: GET ${PLATFORM}/api/v1/checkout/order/${short_id}

<?php
$platform = getenv('PAYORA_PLATFORM_URL') ?: 'http://217.216.38.82:3847';
$siteKey  = getenv('PAYORA_SITE_API_KEY');

$payload = json_encode([
  'amount'       => 500,
  'product_name' => 'Diamond Pack',
  'method'       => 'NAGAD',
]);

$ch = curl_init(rtrim($platform, '/') . '/api/v1/checkout/create');
curl_setopt_array($ch, [
  CURLOPT_POST           => true,
  CURLOPT_HTTPHEADER     => [
    'Content-Type: application/json',
    'x-site-key: ' . $siteKey,
  ],
  CURLOPT_POSTFIELDS     => $payload,
  CURLOPT_RETURNTRANSFER => true,
]);
$raw  = curl_exec($ch);
$data = json_decode($raw, true);
curl_close($ch);

if (!empty($data['checkout_url'])) {
  header('Location: ' . $data['checkout_url']);
  exit;
}
echo 'Checkout create failed';

1. Panel → APK → APK ডাউনলোড + Secret Connect Key কপি
2. Install Guide অনুসারে Play Protect / permissions সেট করুন
3. অ্যাপে Key দিয়ে Save → Start
4. Panel এ App Connected দেখা যাবে

APK offline থাকলেও কাস্টমার পেমেন্ট করতে পারবে · অর্ডার pending থাকবে · APK online হলে auto verify হবে। বিস্তারিত: Offline / Pending section।

মার্চেন্টের ফোনে Auto Payment অ্যাপ বন্ধ বা অফলাইন থাকলেও কাস্টমার ওয়েবসাইট থেকে অর্ডার/চেকআউট করতে পারবে। সিস্টেম অর্ডারকে pending রাখে। অ্যাপ আবার অনলাইন হলে SMS/notification মিলিয়ে auto verify → paid হয়।

Status values you will see

GET http://217.216.38.82:3847/api/v1/checkout/order/SHORT_ID

"status": "pending"  → waiting for SMS/APK verify (app may be offline)
"status": "paid"     → deliver product / mark order complete
"status": "failed"   → show retry / contact support

Pseudocode (any language):
1) create checkout → redirect checkout_url
2) on return/waiting page:
   loop every 2–3s:
     status = GET /api/v1/checkout/order/{short_id}
     if status == "paid":   deliver + break
     if status == "failed": show fail + break
     else: show "Pending · verifying payment…"
3) Do NOT assume paid just because customer opened checkout

নন-ডেভেলপার: এই সেকশন + Platform URL + Site API Key ডেভেলপারকে দিয়ে বলুন - “pending থাকলে poll করে paid হলে ডেলিভারি দিতে হবে, APK offline হলেও সাইট বন্ধ করা যাবে না।”

• ✓Panel এ Website অ্যাড + Site API Key কপি করা
• ✓Env এ PAYORA_PLATFORM_URL + PAYORA_SITE_API_KEY সেট
• ✓Backend এ checkout/create call (server-side)
• ✓Customer redirect → checkout_url
• ✓Status poll → paid হলেই ডেলিভারি (pending এ ডেলিভারি নয়)
• ✓Offline/pending UX: waiting message (APK offline = normal)
• ✓Receive numbers (bKash/Nagad/Rocket) প্যানেলে সেট
• ✓ফোনে Auto Payment APK Start + online
• ✓টেস্ট: APK stop করে অর্ডার → pending → APK start → auto paid