Refund

post

https://svra.interpaypos.com:1443/

Refunds a settled transaction back to the cardholder. For unsettled transactions, use Void Sale instead.

Body Params

TERMID

string

required

^[a-zA-Z0-9]{8}$

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

PASS

string

required

length ≤ 16

^[a-zA-Z0-9]+$

Password for the Terminal ID (provided by SportsPay).

TYPE

string

enum

required

Type of transaction (R for Refund).

Allowed:

AMT

string

required

^\d+\.\d{2}$

Amount to be refunded in dollars and cents (numeric with decimal).

TOKEN

string

required

^[a-zA-Z0-9]{16,19}$

Tokenized card data (16-19 alphanumeric characters). Accepts either a One-Time Token (OTT) from Embedded Tokenization or a permanent token.

REF

string

required

^[a-zA-Z0-9\-/]{5,40}$

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

PLATFEE

string

^\d+\.\d{2}$

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

PLATCHRG

string

^\d+\.\d{2}$

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

CUSTNAME

string

^[a-zA-Z0-9 \-'.]{1,40}$

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

CUSTEMAIL

string

^[\w\.-]+@[a-zA-Z\d\.-]+\.[a-zA-Z]{2,}$

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

INV

string

^[a-zA-Z0-9]{5,20}$

Invoice number associated with the transaction (5-20 alphanumeric characters). Acts as a transaction tag — does not need to be unique. For refunds, it is useful to input the invoice number from the original sale transaction to link the refund to it.

DESC

string

^[\w\s\W]{1,60}$

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

PROGRAM

array of objects

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.

PROGRAM

PLAYER

array of objects

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

PLAYER

ACCOUNT

array of objects

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

ACCOUNT

SPLIT

string

^[a-zA-Z0-9&\[\]=. ]+$

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

Refund

Related

Related

200SUCCESSFUL TRANSACTION

Related

Related