Introduction

Welcome to Salam Gateway - a modern payment gateway designed for Malaysian businesses.

Features

• FPX Payments - Direct bank transfers via Malaysia's FPX network
• Card Payments - Visa, Mastercard (coming soon)
• Real-time Webhooks - Instant payment notifications
• Dashboard - Monitor transactions and analytics
• Developer SDKs - Node.js and browser integrations

How It Works

1. Create Payment - Call our API to create a payment
2. Redirect Customer - Send customer to the checkout page
3. Customer Pays - Customer completes payment via FPX
4. Receive Webhook - Get notified when payment completes
5. Fulfill Order - Process the order

Payment Flow

Typical Integration

// 1. Create a payment on your server
const payment = await salam.payments.create({
  amount: 10000, // RM 100.00
  description: 'Premium subscription',
  success_url: 'https://yoursite.com/success',
  cancel_url: 'https://yoursite.com/cancel',
});

// 2. Redirect customer to checkout
res.redirect(payment.redirect_url);

// 3. Handle webhook notification
app.post('/webhooks/salam', (req, res) => {
  const event = salam.webhooks.constructEvent(req.body, req.headers['salam-signature']);
  
  if (event.type === 'payment.captured') {
    // Payment successful - fulfill the order
    fulfillOrder(event.data.id);
  }
  
  res.json({ received: true });
});

Key Concepts

Payments

A Payment represents a customer's attempt to send you money. Payments have a lifecycle:

Pending → Authorized → Captured → Settled

Payment Methods

Currently supported:

• FPX - Online banking for Malaysian banks
• Card (Coming soon) - Visa, Mastercard

Webhooks

Webhooks notify your server when events occur:

• Payment captured
• Payment failed
• Refund processed

Test Mode vs Live Mode

Every account has test and live API keys:

• Test mode - Use test keys for development
• Live mode - Use live keys for production

Next Steps

🚀Quick StartAccept your first payment in 5 minutes🔑AuthenticationLearn about API keys🧪Test ModeTest payments without real money

Support

Need help? We're here for you:

• 📧 Email: support@salamgateway.com
• 💬 Discord: Join our community
• 📚 Documentation: You're already here!
• 🐛 Issues: GitHub Issues

API Status

Check our status page: status.salamgateway.com

Getting Started

Ready to integrate? Start with our Quick Start Guide to accept your first payment in under 5 minutes.