Quickstart

Getting started with Evolve Payments only takes a few minutes. Follow the rest of this guide to learn how to set up your organization.

Basic Integration

Test Mode Setup:

Make sure to swap in your real API key below.

const evolve = new EvolvePayments({
  apiKey: 'test_key_your_test_key_here',
  environment: 'sandbox'
});

Process a Payment:

const payment = await evolve.charges.create({
  amount: 2999, // $29.99 in cents
  currency: 'usd',
  paymentMethod: {
    type: 'card',
    number: '4242424242424242',
    expMonth: 12,
    expYear: 2025,
    cvc: '123'
  },
  description: 'Test purchase'
});

Handle Responses

if (payment.status === 'succeeded') {
  // Payment successful
  console.log('Payment ID:', payment.id);
} else {
  // Handle failed payment
  console.log('Error:', payment.error);
}

Go Live

1. Complete account verification in your dashboard

2. Switch to live API keys

3. Update environment to 'production'

Key Features

• Supported Methods: Credit cards, digital wallets, bank transfers

• Security: PCI DSS compliant, encrypted transactions

• Fees: 2.9% + 30¢ per successful transaction

• Settlement: Next business day deposits