Quick Start Guide

Get up and running with GlobalPay.bt in minutes.

Prerequisites

Before you begin, ensure you have:

• A registered business in Bhutan
• Bank of Bhutan IPG merchant account
• BOB IPG API credentials (Merchant ID, API Key, Terminal ID)

Step 1: Create Your Account

1. Visit app.gopay.bt/sign-up
2. Fill in your business details
3. Verify your email address
4. Complete your profile

Step 2: Configure BOB IPG Credentials

1. Navigate to Settings > Payment Gateway
2. Enter your BOB IPG credentials:
   • Merchant ID
   • API Key
   • Terminal ID
   • Gateway URL (provided by BOB)
3. Click Save Configuration

Step 3: Create Your First Invoice

1. Go to Invoices > Create New\n2. Fill in customer details\n3. Add line items\n4. Click "Create & Send"

Step 4: Test a Payment

Use these test card numbers to verify your integration:

| Card Type | Card Number | CVV | Expiry | |-----------|-------------|-----|--------| | Visa | 4111 1111 1111 1111 | 123 | Any future date | | Mastercard | 5555 5555 5555 4444 | 123 | Any future date |

Step 5: Handle Webhooks

Set up webhooks to receive real-time payment notifications:

1. Go to Settings > Webhooks
2. Add your webhook URL (e.g., https://yourdomain.com/webhooks/payments)
3. Select events to subscribe to
4. Save your webhook secret for signature verification

Example webhook handler:

// Node.js example
app.post('/webhooks/payments', (req, res) => {
  const signature = req.headers['x-globalpay-signature'];
  const payload = req.body;
  
  // Verify signature
  if (verifySignature(payload, signature)) {
    switch (payload.event) {
      case 'payment.completed':
        // Handle successful payment
        break;
      case 'payment.failed':
        // Handle failed payment
        break;
    }
  }
  
  res.sendStatus(200);
});

Step 6: Go Live

Once you've tested thoroughly:

1. Switch to Live Mode in the dashboard
2. Use your production BOB IPG credentials
3. Start accepting real payments

Next Steps

• Authentication - Learn about API authentication
• API Reference - Explore all API endpoints
• Integration Guides - Detailed integration tutorials

Need Help?

• Check our Help Center
• Email us at support@gopay.bt
• Call +975 77 88 33 44