Customized Checkout

Body Params

Create a new redirect session that to securely process a payment directly between the customer’s web browser and the SportsPay's gateway.

string
required

Terminal ID of the merchant (8 alphanumeric characters). Must always be the first field.

string
required
length ≤ 16

Password for the Terminal ID (provided by SportsPay).

string
enum
required

Type of transaction (W for Web-Redirect).

Allowed:
string
enum
required

Defines the action to perform. For this request, it will be StartSession.

Allowed:
string
required

Amount to transfer in dollar and cents (numeric with decimal).

string

Customer's name (max 40 characters; accepts alphanumeric, spaces, -, ', and .).

string
required

Customer's email address (max 60 characters; accepts standard email characters: alphanumeric and @ . ! # $ % + - _ { | } ~).

string

Platform-side customer identifier (max 40 characters; accepts alphanumeric, -, and _). Used to associate the transaction with a customer record in your system. Enables customer vaulting — payment methods saved under a CUSTID can be reused for future one-time or installment payments.

string
required

Unique value assigned to the payment session to avoid duplicate sessions (5-20 digits).

string
enum

Language to display to the customer: E for English, F for French (defaults to English).

Allowed:
string

Unique reference number attached to the transaction (8-40 characters; accepts alphanumeric, -, and /). Must be unique within the current batch.

string

Invoice number associated with the transaction (5-20 alphanumeric characters). Acts as a transaction tag — does not need to be unique.

string

Description of payment (up to 60 characters; accepts alphanumeric, spaces, symbols and punctuation marks).

string

Program-level line items associated with the transaction. Appears in the Deposit Report to provide a breakdown of charges contributing to a deposit. Multiple PROGRAM entries may be included.

string

Player-level line items associated with the transaction. Appears in the Deposit Report alongside PROGRAM entries. Multiple PLAYER entries may be included.

string

Account-level line items associated with the transaction. Appears in the Deposit Report alongside PROGRAM and PLAYER entries. Multiple ACCOUNT entries may be included.

string

Platform Billing amount - Gateway applies as Platform Fee (added to transaction) if CustomerPay, or Platform Charge (deducted) if Merchant Pay. Amount in dollars and cents (mutually exclusive with PLATFEE and PLATCHRG)

string

Platform Fee - Amount to add to transaction amount in dollars and cents (mutually exclusive with PLATFORM and PLATCHRG).

string

Platform Charge - Amount to subtract from transaction amount in dollars and cents (mutually exclusive with PLATFORM PLATFEE).

string

The Split Payment information, formatted as multiple key-value pairs inside brackets. Each Split Payment entry must be enclosed in square brackets and can include multiple fields separated by &. Example format: [TRANGP=TESTGRP&RECV=DEVM0058&AMT=1.20&REF=12345678&MSG=DEMOTRANSFER].

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json