Getting Started

Quick start guide to integrate 1-CP Corporate Checkout

Welcome to 1-CP Corporate Checkout! This guide will help you integrate our corporate payment solution into your application in just a few minutes.

Overview

1-CP Corporate Checkout is a comprehensive payment solution designed specifically for corporate transactions. It provides:

• Streamlined Corporate Purchasing: Simplify business expense management

• Multiple Payment Methods: Support for cards, corporate accounts, and virtual payment solutions

• Compliance & Reporting: Built-in compliance features and detailed reporting

• Global Currency Support: Process payments in multiple currencies worldwide

Prerequisites

Before you begin, ensure you have:

• 1-CP Account: Sign up for a staging account

• Business Unit Setup: Configure your business unit in the dashboard

• API Credentials: Obtain your client-id and client-secret

• Development Environment: Node.js 14+ or any web development setup

Quick Start (5 minutes)

Step 1: Get Your Credentials

1. Log in to the Staging Dashboard

2. Navigate to Config → Widget

3. Create a new widget configuration

4. Copy your client-id and client-secret

Step 2: Install the SDK

Choose your preferred installation method:

NPM:

npm install @one-cp/web-checkout

CDN:

<script src="https://one-cp-public.s3.eu-central-1.amazonaws.com/init.min.js"></script>

Step 3: Create Your First Transaction

Backend (Create Transaction):

// Example using Node.js/Express
// For complete API documentation: https://docs.one-cp.com/api-reference
const response = await fetch('https://api.1-cp.io/v1/transactions/initialize', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: "Hotel Booking",
    currency: "EUR",
    items: [{
      name: "Business Hotel Room",
      category: "ACCOMMODATION",
      price: 15000, // €150.00 in minor units
      quantity: {
        amount: 2,
        unit: "FLAT_FEE"
      }
    }]
  })
});

const { transactionID } = await response.json();

Frontend (Initialize Checkout):

import { init } from '@one-cp/web-checkout';

// Initialize checkout
init({
  transactionID: 'your-transaction-id',
  widgetID: 'your-widget-id',
  config: {
    env: 'sandbox', // Use 'production' for live transactions
    mode: 'lightbox'
  },
  onSuccess: (data) => {
    console.log('Payment completed successfully!', data);
    // Handle successful payment
  },
  onError: (error) => {
    console.error('Payment failed:', error);
    // Handle payment errors
  }
});

Step 4: Test Your Integration

Use our test credentials to verify your setup:

Test Card Numbers:

• Visa: 4242 4242 4242 4242

• Mastercard: 5555 5555 5555 4444

• CVV: 123

• Expiry: Any future date

Configuration Options

Environment Setup

Configure your environment based on your needs:

const config = {
  env: 'sandbox',        // 'sandbox' | 'production'
  mode: 'lightbox',      // 'lightbox' | 'inline'
  lang: 'en', // 'en' | 'de'
  redirectURL: 'https://yoursite.com/success'
};

Payment Methods

Configure which payment methods to accept:

1. Navigate to Dashboard → Payment Configuration

2. Select your payment providers / acquirer

3. Configure payment method restrictions

4. Set up business unit mappings

Webhook Configuration

Set up webhooks to receive real-time payment notifications:

1. Go to Dashboard → Configurations → Connectors

2. Create a new Webhook connector

3. Configure your endpoint URL

4. Select event triggers (create, update, complete, etc.)

Common Integration Patterns

E-commerce Integration

// Add to your checkout flow
function initiatePayment(cartItems) {
  const transactionData = {
    title: "Purchase Order #12345",
    currency: "USD",
    items: cartItems.map(item => ({
      name: item.name,
      category: item.category,
      price: item.price * 100, // Convert to minor units
      quantity: {
        amount: item.quantity,
        unit: "FLAT_FEE"
      }
    }))
  };
  
  // Create transaction via your backend
  createTransaction(transactionData)
    .then(({ transactionID }) => {
      init({
        transactionID,
        widgetID: 'your-widget-id',
        config: { env: 'production' },
        onSuccess: handlePaymentSuccess,
        onError: handlePaymentError
      });
    });
}

Travel Booking Integration

// Travel-specific transaction
const travelTransaction = {
  title: "Business Trip - Berlin",
  currency: "EUR",
  items: [
    {
      name: "Hotel Accommodation",
      category: "ACCOMMODATION",
      price: 25000, // €250.00
      accommodationType: "HOTEL",
      roomType: "SINGLE",
      period: {
        start: "2025-12-01T15:00:00Z",
        end: "2025-12-03T11:00:00Z"
      },
      location: {
        street: "Unter den Linden",
        house: "1",
        city: "Berlin",
        country: "Germany",
        postCode: "10117"
      }
    },
    {
      name: "Flight Ticket",
      category: "FLIGHT",
      price: 45000, // €450.00
      flightNumber: "LH441",
      departure: "FRA",
      destination: "TXL",
      serviceClass: "BUSINESS_CLASS"
    }
  ]
};

Next Steps

Now that you have a basic integration running:

1. Configure Payment Methods: Set up your preferred payment providers

2. Customize Appearance: Brand the checkout experience with your colors and logo

3. Set Up Reporting: Configure webhooks and reporting connectors

4. Test Thoroughly: Use our comprehensive test scenarios

5. Go Live: Switch to production environment

Need Help?

• Documentation: Browse our complete API reference and guides

• Test Scenarios: Review our certification test cases

• Support: Contact our integration team at [email protected]

• Community: Join our developer community forum

Troubleshooting

Common Issues

Invalid Transaction ID

• Ensure the transaction was created successfully

• Check that you're using the correct environment (sandbox/production)

• Verify your API credentials are valid

Payment Method Not Available

• Check your payment configuration in the dashboard

• Ensure the payment method is enabled for your business unit

• Verify currency compatibility

Checkout Not Loading

• Confirm the SDK is loaded correctly

• Check for JavaScript console errors

• Ensure the container element exists (for inline mode)

For more detailed troubleshooting, see our Error Messages reference.