Quick Start Guide

This guide walks you through the basic workflow for integrating with the Trustist Ecommerce API. Follow these steps to get up and running quickly.

Prerequisites

Before you begin, ensure you have:
  • A Trustist account with API access
  • Your API key ID and secret key from the TrustistTransfer app
  • A development environment with your preferred programming language

Integration Workflow

Follow these steps to integrate Trustist into your application:

Step 1: Set Up Authentication

Get your API keys from the TrustistTransfer app. See our API Keys Guide for details.

  • Get your API key ID and secret from the TrustistTransfer app
  • Choose your preferred programming language
  • Follow the integration example for your language: JavaScript, .NET, Node.js, PHP, Python

Step 2: Create Customers

Create customer records to associate with identity verification sessions and payments.

Endpoint:

POST/v1/customers

Permissions: create_customer

Response:

{
  "id": "customer-guid",
  "firstName": "John",
  "lastName": "Doe"
}

Step 3: Start Identity Verification Sessions

Initiate identity verification and KYC checks for your customers.

Endpoint:

POST/v1/onboard/sessions

Permissions: create_onboard_session

Response:

{
  "id": "session-guid",
  "redirectUrl": "https://onboard.trustist.com/xyz"
}

Step 4: Handle Webhooks

Set up webhooks to receive real-time notifications about session completions and payment events.

Step 5: Process Payments

Once customers are onboarded, you can process payments on their behalf.

Endpoint:

POST/v1/payments

Permissions: create_payment

Response:

{
  "id": "payment-guid",
  "payLink": "https://pay.trustist.com/xyz"
}

Testing Your Integration

Test your integration using our sandbox environment:

  • Use https://api-sandbox.trustistecommerce.com for API calls
  • Create a sandbox account for testing
  • Use test bank accounts and card details
  • Monitor payment statuses during testing

Next Steps

Now that you understand the basic workflow:

  1. Choose your integration example: JavaScript | .NET | Node.js | PHP | Python
  2. Read the detailed Authentication Guide
  3. Browse the API Reference for complete endpoint documentation
  4. Set up testing in the sandbox environment
  5. Configure webhooks for real-time notifications