This guide covers the core card submission endpoint that allows you to process payments by submitting card and customer information for a specific product.

Please also consult the API Reference for detailed information on the Card Submission API.

​
Prerequisites

Before starting the integration, ensure you have:

Paysight Account

Active merchant account with Paysight

Client ID

Find this in your Account Section

API Credentials

API key available in your Account Section

Product ID

Available from your Product Management section.

Development Environment

Set up for testing

Always use the test environment (test.paysight.io) during development and testing phases.

​
API Endpoint Overview

The card submission API processes payment transactions by accepting card details and customer information.

​
Base URL

  • Test Environment: https://test.paysight.io

​
Endpoint

  • Method: POST
  • Path: /api/{productId}

​
Step-by-Step Integration

​
Step 1: Authentication Setup

The API uses API key authentication passed in the Authorization header.

'Authorization':  'your-api-key-here',
'ClientId': 'your-client-id',
'UserEmail': 'your-paysight-account-email',
'Content-Type':  'application/json'

​
Step 2: Prepare Request Payload

The API expects a comprehensive payload with card, customer, and transaction details.

​
Minimum Required Request Body (JSON)

{
  "paysightSession": null, // required if partnerSession is null
  "partnerSession": "abcdefg12345", // required if paysightSession is null
  "card": {
    "name": "John Smith",
    "pan": "4111111111111111",
    "expiryMonth": 12,
    "expiryYear": 2029,
    "cvv": "333"
  },
  "email": "johnsmith@gmail.com",
  "amount": 1
}

​
Session Management

ParameterTypeDescription
paysightSessionstringUnique identifier of the session/user visit (generated by Paysight).
partnerSessionstringPartner/client assigned unique identifier of the session/user visit. Persist this value between calls for the same user session.

​
Step 3: Make a Request to API

​
Base URL

  • Test Environment: https://test.paysight.io

​
Endpoint

  • Method: POST
  • Path: /api/{productId}

​
Step 4: Handle the Response

The API returns a comprehensive response with transaction details:

{
  "paysightSession": "<string>",
  "partnerSession": "<string>",
  "subscribeSuccess": true,
  "chargeSuccess": true,
  "info": "<string>",
  "error": "<string>",
  "email": "<string>",
  "message": "<string>",
  "orderId": 123,
  "descriptor": "<string>",
  "mid": "<string>",
  "threeDSecureId": "<string>",
  "transactionId": "<string>",
  "amount": 123
}

​
Step 5: Process Response

Use the response from the API to handle as required per your solution. For example:

  • Redirect customer to thank you page if chargeSuccess: true
  • Send the data to your internal system for additional processing and logic

​
Step 6: Go Live Checklist

1

Test Production Integration

Test the integration using a production ProductId with the production endpoint (prod.paysight.io)

2

Verify Setup

Verify the integration with your Paysight account manager to ensure everything is set up correctly

3

Await Approval

Wait for a GO LIVE message from your account manager before proceeding with live traffic

​
Next Steps

Payment API Reference

Explore the complete API documentation

Error Handling

Learn about error handling and troubleshooting

Testing Guide

Best practices for testing your integration