Integrate Your Client’s App with Blackstone Payment Gateway

Introduction

Integrating your app with Blackstone Merchant Services’ bPayd Gateway allows you to accept payments securely, automate transactions, and enhance customer experience across web, mobile, and in-store platforms.
This article will walk you through the complete integration process — from creating your developer account to going live with real transactions.

Step 1: Create a Developer Account

Start by signing up on the Blackstone Developer Portal.
Once registered, you’ll gain access to:

• Your Dashboard for managing projects

• API keys (Sandbox & Live)

• SDK documentation and test credentials

💡 Pro Tip: Use separate sandbox credentials during development to simulate transactions safely.

Step 2: Choose Your Integration Type

Blackstone supports multiple integration options based on your app type:

• Mobile App SDK (iOS/Android): For apps built in Swift, Kotlin, or Flutter.

• Web SDK: For online stores or web-based platforms.

• Hosted Checkout Page: For quick PCI-compliant setups without coding.

• Custom API Integration: For full control over checkout and transaction logic.

Choose the one that fits your app’s architecture and follow its specific SDK documentation.

Step 3: Install the SDK

For iOS (Swift)

Add via Swift Package Manager:

.package(url: "https://github.com/blackstone/bpayd-ios-sdk.git", from: "1.0.0")

Then import and initialize:

import BPayd
BPayd.initialize(publicKey: "pk_sandbox_xxxxx")

For Android (Kotlin)

Add dependency in build.gradle:

implementation 'com.blackstone.bpayd:bpayd-android-sdk:1.0.0'

Initialize it in your Application class:

BPayd.initialize(context = this, publicKey = "pk_sandbox_xxxxx")

⚙️ The SDK handles encryption, PCI compliance, and tokenization automatically.

Step 4: Configure API Keys

After SDK installation, configure your Sandbox API keys in your app or backend environment.
You’ll need two sets:

• Public Key – used on the client side (safe to expose)

• Secret Key – used on your backend server (keep secure)

Example .env configuration:

BPAYD_PUBLIC_KEY=pk_sandbox_xxxxx
BPAYD_SECRET_KEY=sk_sandbox_xxxxx

Step 5: Create a Payment Intent

The Payment Intent is the foundation of each transaction.

Example API request from your backend:

curl -X POST https://api.bpayd.com/v1/payment_intents \
  -H "Authorization: Bearer sk_sandbox_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2500,
    "currency": "USD",
    "description": "Order #1021",
    "capture_method": "automatic"
  }'

This returns a client_secret, which is then used by your frontend or mobile SDK to confirm the payment.

Step 6: Confirm the Payment in Your App

Mobile Example (Swift)

BPayd.confirmPayment(clientSecret: "pi_123_secret_456") { result in
    if result.status == .succeeded {
        print("Payment successful!")
    } else {
        print("Payment failed: \(result.message)")
    }
}

Web Example (JS)

BPayd.confirmPayment({
  clientSecret: 'pi_123_secret_456',
  paymentMethod: { type: 'card' }
}).then(result => {
  if (result.status === 'succeeded') {
    console.log('Payment successful!');
  }
});

Step 7: Set Up Webhooks

Webhooks keep your backend synchronized with payment events such as:

• payment_intent.succeeded

• payment_intent.failed

• refund.created

Example Node.js webhook:

app.post('/webhooks/bpayd', (req, res) => {
  const event = req.body;
  if (event.type === 'payment_intent.succeeded') {
    // Update order status to paid
  }
  res.sendStatus(200);
});

🧠 Tip: Always verify webhook signatures for security using your webhook secret key.

Step 8: Test in Sandbox Mode

Use Blackstone’s sandbox environment to test every possible flow:

• Successful payments

• Failed transactions

• Refunds and pre-authorizations

• 3D Secure (SCA) authentication

All test results will appear in your Developer Dashboard under “Transactions.”

Step 9: Go Live

Once your integration is tested and approved:

1. Replace Sandbox API keys with Live keys.

2. Verify webhooks point to production.

3. Run a $1 live transaction for validation.

4. Enable fraud monitoring and settlement alerts in your dashboard.

Congratulations — your app is now live and fully integrated with Blackstone’s bPayd Payment Gateway.

Step 10: Monitor and Optimize

Use the Merchant Dashboard for:

• Transaction tracking

• Real-time analytics

• Refund management

• Subscription monitoring

• API usage metrics

You can also automate reporting using our Analytics API for enterprise-level integrations.

Subsection: Why Integrate with Blackstone?

Integrating with Blackstone’s bPayd Gateway gives developers and businesses access to:

• PCI DSS Level 1 Security

• Multi-currency support

• Digital wallets (Apple Pay, Google Pay)

• Tokenized recurring billing

• Developer-friendly SDKs

• 24/7 integration support

Whether you’re building a mobile app, online store, or platform service — Blackstone gives you the infrastructure to accept payments anywhere securely and efficiently.

Conclusion

Integrating your app with Blackstone’s Payment Gateway opens the door to smarter, faster, and more reliable payment solutions.
With a few lines of code and the right setup, you can connect your clients’ apps to a fully managed, PCI-compliant payment ecosystem built for scalability and success.