Skip to content

Enums

Values are case-sensitive unless a page says otherwise, and several are spelled differently on the way in and the way out. Those pairs are the ones worth reading twice.

This page is generated from the API description, so it cannot drift from it.

Transactions

TransactionCreateType

type on POST /v1/transactions.

ValueMeaning
SALERequests payment card or ACH authorization with an immediate, automatic capture of authorized funds. Includes payment cards and ACH debits. Funds transferred from customer to merchant.
AUTHRequests payment card authorization that is not automatically captured. Completed by a manual capture of the authorized funds.
PAYOUTAn ACH credit. Funds transferred from merchant to customer.

TransactionResponseType

type on a response, and the type report filter.

ValueMeaning
SALEPayment card or ACH authorization with an immediate, automatic capture of the authorized funds. Funds transferred from customer to merchant.
AUTHPayment card authorization that was not automatically captured, and is completed by a manual capture.
INCREMENTAL_AUTHAn authorization that raised the amount held by an earlier AUTH.
PAYOUTAn ACH credit. Funds transferred from merchant to customer.
REFUNDA refund of a settled payment. Funds transferred from merchant to customer.
CANCELA payment cancelled before settlement. Covers a void, a reversal, and a reversed transaction, which the gateway reports under this single value.
CAPTUREManual capture of an authorized payment.

TransactionType

The type discriminator on a cancel or refund body.

ValueMeaning
SALERequests payment card or ACH authorization with an immediate, automatic capture of authorized funds. Includes payment cards and ACH debits. Funds transferred from customer to merchant.
AUTHRequests for payment card authorization that is not automatically captured. Transaction is completed by manual capture of authorized funds.
PAYOUTAn ACH credit. Funds tranferred from merchant to customer.
REFUNDRefunds a settled payment. Funds tranferred from merchant to customer.
VOIDCancels a SALE or captured AUTH before settlement.
CAPTUREManually captures an authorized payment.

Result

result on every transaction.

ValueMeaning
APPROVEDThe transaction was approved by the issuer.
DECLINEDThe transaction was declined by the issuer.
ERRORThe transaction experienced an error after it was successfully created by the API server.

Initiator

initiator.

ValueMeaning
MERCHANTMerchant-initiated transaction (MIT) — billed without the cardholder present.
CUSTOMERCustomer-initiated transaction (CIT) — the cardholder is actively present.
THIRD_PARTYInitiated by a third party on the merchant's behalf.

RecurringSequence

recurring_details.sequence.

ValueMeaning
INITIALThe first, customer-initiated (CIT) transaction in the agreement. Establishes the stored credential.
SUBSEQUENTA follow-on transaction billed against the agreement established by the INITIAL transaction. Usually merchant-initiated (MIT).

SettlementIssue

settlement_issue.

ValueMeaning
REMOVED_FROM_BATCHThe transaction was removed from its batch before settlement.
null—

Payment methods

PaymentMethodTypeInput

payment_method.type on a request.

ValueMeaning
ACHA bank account debited or credited over ACH.
CardA credit or debit card.
TokenA stored payment method, referenced by its token.

PaymentMethodTypeOutput

payment_method.type on a response.

ValueMeaning
ACHA bank account debited or credited over ACH.
CARDA credit or debit card.

EntryMethod

payment_method.entry_method on a request.

ValueMeaning
MOTOA Card Not Present entry method where the payment method information was obtained over the phone or via postal mail.
ECOMMERCEA Card Not Present entry method where the payment method information was obtained over the Internet via a web browser.
null—

CardType

payment_method.card_type.

DEBIT, CREDIT, UNKNOWN

AvsResultCode

payment_method.avs_result_code.

ValueMeaning
AThe street address matched, but the postal code did not.
BNo address information was provided or transaction declined.
NNeither the street address nor postal code matched.
PAVS is not applicable for this transaction.
RRetry — AVS was unavailable or timed out.
SAVS is not supported by card issuer.
UAddress information is unavailable.
WThe US ZIP+4 code matches, but the street address does not.
XBoth the street address and the US ZIP+4 code matched.
YThe street address and postal code matched.
ZThe postal code matched, but the street address did not.
0AVS not requested or not applicable.

BankAccountType

payment_method.account_type.

ValueMeaning
CHECKINGChecking account.
SAVINGSSavings account.

StandardEntryClass

payment_method.standard_entry_class.

ValueMeaning
PPDPrearranged Payment and Deposit — consumer account transactions authorized in writing.
CCDCorporate Credit or Debit — business-to-business ACH transactions.
WEBInternet-initiated entries — consumer transactions authorized via the internet.
TELTelephone-initiated entries — consumer transactions authorized by phone.
POPPoint-of-Purchase — check conversion transactions at the point of sale.
BOCBack Office Conversion — check conversion after the sale.

Batches and processors

BatchType

batch_type on a batch close.

ValueMeaning
CreditCredit batch — contains credit/sale transactions.
DebitDebit batch — contains debit transactions.

OpenBatchCardType

card_type on GET /v1/batches/transactions.

DEBIT, CREDIT

Processor

processor in a request body.

ValueMeaning
TsysTSYS payment processor
VericheckVericheck ACH processor

IntegrationsEnum

integrations on a response, and the integration filter.

ValueMeaning
TSYSThe TSYS card processor. Returned on card transactions.
VERICHECKThe Vericheck ACH processor. Returned on bank account (ACH) transactions.

Clients

ClientType

type on a client.

ValueMeaning
resellerReseller — a client that resells services to merchants.
merchantMerchant — a client that processes payments.

ClientAddressType

address[].type.

ValueMeaning
LEGALThe client's registered legal address.
BILLINGThe address used for billing the client.
PHYSICALThe client's physical location address.

TimeZone

time_zone on admin contact details.

ValueMeaning
America/Los_AngelesPacific Time Zone
America/PhoenixMountain Standard Time (MST, no DST)
America/DenverMountain Time Zone
America/ChicagoCentral Time Zone
America/New_YorkEastern Time Zone
Pacific/HonoluluHawaii-Aleutian Standard Time (HAST)
America/AnchorageAlaska Time Zone

Sorting

SortOrder

sort_order.

ValueMeaning
ASCAscending order (oldest first).
DESCDescending order (newest first).

Where the vocabularies differ

Three pairs catch people out.

RequestResponse
Transaction typeSALE, AUTH, PAYOUTadds INCREMENTAL_AUTH, REFUND, CANCEL, CAPTURE
Payment method typeACH, Card, TokenACH, CARD
ProcessorTsys, VericheckTSYS, VERICHECK

You send VOID and you read CANCEL. There is no VOID in the response vocabulary, and filtering a report on it returns a server error.

payment_method.type is mixed case on a request. Card and Token, not CARD and TOKEN.

entry_method is a different vocabulary again on a response — a free-form string naming how the card was read (keyed, swiped, chip, contactless, magstripe, barcode, qr, other), not one of the two request values.

Next steps