Constant transaction values

When working with and querying transaction data, the following numerical values are returned which represent the corresponding constant value.

This page has the following reference tables for constant values:

Card type (cardType)

The Nexio cardType parameter is used with the View transactions endpoint in the request and returned as a number in the response. You can only send values for 10, 20, 30, 40, and 50. And in the response, you will only get those values or null, depending on the card used in the transaction.

ValueCard type nameName in webhook
10Visavisa
20MasterCardmastercard or masterCard
30Discoverdiscover
40American Expressamex or americanExpress
50JCBjcb
nullDiners Clubnull
nullCarte Blanchenull
nullUnknownnull

Chargeback cycle (chargebackCycle)

The Nexio chargebackCycle parameter is used with the View a chargeback and View chargebacks endpoints.

This value includes what part of the cycle the chargeback is currently in.

ValueNameDescription
0CanceledThe dispute was canceled.
1InitialThe cardholder, through their credit card issuing bank, has identified this transaction as being either suspicious, or the merchant didn’t deliver what they promised. The issuing bank has transferred the funds back to the cardholder. See the reason code to better understand the cardholder’s reasoning.

At this point, the merchant has the opportunity to submit compelling evidence to dispute the cardholder’s claim. The production Nexio Dashboard makes submission of the dispute very easy and convenient. This submission is routed through the merchant’s processor and the merchant’s acquiring bank.

Note: In rare instances, the merchant may get a chargeback with this cycle type but with an amount that is positive. This typically means that the issuing bank was unable to get the funds from the original Initial chargeback to the cardholder, so the funds automatically reverse back to the merchant's account. For these cases, you do not need to dispute the chargeback.
2WonBased on the submission of the compelling evidence to dispute the cardholder’s claims in the chargeback (see Cycle Type 1: Initial), a reversal of funds is conditionally awarded to the merchant.

If the chargeback does not progress further after 2 months, this typically means that the conditional reversal is made final.
3RepresentThe cardholder’s issuing bank has determined that the compelling evidence submitted in the merchant’s original dispute did not justify overturning the original chargeback (see Cycle Type 1: Initial). The conditional reversal of funds to the merchant (see Cycle Type 2: Won) has been overturned - meaning funds are debited from the merchant.

The merchant has the opportunity to submit new compelling evidence to continue to dispute the cardholder’s claim. This submission is routed through the merchant’s processor and the merchant’s acquiring bank. At this time, this submission must take place outside of the Nexio Dashboard.

Caution: If you attempt to dispute the chargeback at this phase a potential outcome could be arbitration and its associated fees.
3.1Represent (Open)The cardholder’s issuing bank has determined that the compelling evidence submitted in the merchant’s original dispute did not justify overturning the original chargeback (see Cycle Type 1: Initial). Funds do not move in this Cycle Type.

The merchant has the opportunity to submit new compelling evidence to continue to dispute the cardholder’s claim. This submission is routed through the merchant’s processor and the merchant’s acquiring bank. At this time, this submission must take place outside of the Nexio Dashboard.

Caution: If you attempt to dispute the chargeback at this phase a potential outcome could be arbitration and its associated fees.
3.2Represent (Closed)If the merchant did not attempt to dispute during Cycle Type 3.1: Represent (Open), then the chargeback advances to this Cycle Type automatically.

If the merchant did attempt to dispute during Cycle Type 3.1: Represent (Open) and the issuing bank did not agree with the merchant's dispute, then the chargeback advances to this Cycle Type. The conditional reversal of funds to the merchant (see Cycle Type 2: Won) has been overturned - meaning funds are debited from the merchant. This decision is final.
4FinalBased on the submission of the new compelling evidence to dispute the cardholder’s claims in the chargeback (see Cycle Type 3: Represent), a reversal of funds is awarded to the merchant. This decision is final.
4.1Final (Closed)Based on the submission of the new compelling evidence to dispute the cardholder’s claims in the chargeback (see Cycle Type 3.1: Represent (Open)), the issuing bank did justify overturning the original chargeback. Because funds were already conditionally rewarded to the merchant (see Cycle Type 2: Won), there is no movement of funds. This decision is final.

📘

Note

To check the status of a chargeback, you should get in direct contact with the chargeback department. You can also get information in the Nexio dashboard, but it may not be as up-to-date.

Class (class)

The Nexio class parameter is used with the View transactions endpoint. It is part of the cardMetaData object and refers to the category of card used in the transaction.

NameValue
Credit1
Debit2
Charge card3
Unknown4

Currency ID (currencyId)

The Nexio currencyId parameter is used with the View transactions endpoint.

NameValue
Australian Dollar036
Canadian Dollar124
Yuan156
Yen392
Won410
Mexican Peso484
Pound Sterling826
US Dollar840
Euro978

Payment type (paymentType)

A payment type indicates the type of transaction being processed using stored payment credentials. This field is required to properly flag initial and subsequent transactions. Also, sending an incorrect value may result in fines to the merchant account from card schemes (Mastercard, Visa, and so forth). Please note that cardholder authentication (3D Secure) may be required depending on card issuer requirements.

Nexio defaults to initialUnscheduled for any of the following:

Nexio defaults to initialScheduled for any of the following:

Nexio defaults to scheduled for the following:

🚧

Important

Because Nexio sends a default, if you do not pass the paymentType parameter and rely on the default value, any mislabeled paymentType that results in declines, non-compliance, and/or fines will be the responsibility of the merchant.

You indicate a payment type when you run a card transaction by including processingOptions.paymentType in the body of your request. See the table below for possible values and explanations.

Payment TypeDescription
initialScheduledIndicates a customer-initiated first transaction in a series of scheduled or recurring transactions. For subsequent transactions, use scheduled.
initialUnscheduledIndicates a customer-initiated first transaction that is not part of a series of scheduled or recurring transactions. For subsequent transactions, use either unscheduledCit or unscheduledMit.
scheduledIndicates a merchant-initiated subsequent transaction in a series of scheduled or recurring transactions.
unscheduledCitIndicates a customer-initiated subsequent transaction that is not part of a series of scheduled or recurring transactions.
unscheduledMitIndicates a merchant-initiated subsequent transaction that is not part of a series of scheduled or recurring transactions. Customer consent was provided at the time of the initial payment.
initialMotoIndicates a transaction that is captured in a virtual terminal when customer card information is received over the phone, through mail, or via fax.

If the initial transaction was initialMoto, the gateway or processor may not allow subsequent (such as recurring or scheduled) transactions for that payment method. For subsequent transactions that are supported by the gateway or processor, use scheduled, unscheduledCit, or unscheduledMit.

Subsequent transactions

When we say "subsequent" transactions, we mean transactions that are meant to occur after a first transaction as part of a subscription or recurring situation where the customer is not present for that next transaction and you use a saved card token for that subsequent transaction.

This is not the same as a case where a customer would make a purchase once and then again in the future, whether with or without a saved card token. For those, each payment is either an initial transaction (initialUnscheduled or initialMoto) if getting the information from the customer directly each time, or an unscheduled transaction when using a saved card token after that first one (unscheduledCit if the customer selects their saved card or unscheduledMit if the merchant is running the transaction).

Otherwise, on subsequent transactions with a saved card token, use a paymentType of one of the following, depending on the situation:

  • unscheduledMit - The cardholder calls in to make a payment with a "card on file", regardless of the paymentType used for the initial transaction.
  • unscheduledMit - For situations like a cancellation or no-show fee that the merchant initiates.
  • scheduled - When a cardholder enrolled in a series of payments.

Payment type flow

Payment flow diagram

Example request

curl -X POST https://api.nexiopaysandbox.com/pay/v3/process \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Basic [Base64_encoded_login]'
  -d '{
  "data": {
    "amount": 1.15,
    "currency": "USD"
  },
  "tokenex": {
    "token": "6ee140a0-05d1-4958-8325-b38a690dbb9d"
  },
  "processingOptions": {
    "paymentType": "initialScheduled"
  }
}'

Process method (processMethod)

The processMethod parameter gets returned with these endpoints:

The following table shows the possible values and what process method the code corresponds to:

NameValue
Card10
Card Present11
Card Not Present12
APM (Alternative Payment Method)20
Echeck40
Credit50
Cash60

Recovery status (recoveryStatus)

The table below describes the recovery statuses for transactions.

recoveryStatusStatusDescription
10DisabledNo retry attempt made. Can be enabled if the merchant account is configured for Decline Recovery service.
20In progressTransaction request has been sent to the gateway for processing. This is a temporary status.
30ScheduledThe retry attempt has been scheduled.
40UnrecoverableThe declined transaction cannot be retried.
50RecoveredThe transaction has been successfully retried.

Transaction status (transactionStatus)

The tables below describe the transaction statuses for card and echeck transactions.

📘

Note

Card transaction status

StatusDescriptionNexio Dashboard StatusTransaction Service transactionStatusPayment Service transactionStatus
Auth Only PendingThe payment is asynchronous and may receive a webhook notice with a status of authOnly in the futureAUTHONLYPENDING3authOnlyPending
Authorized PendingThe payment is asynchronous. The payment is pending and may receive a webhook notice with status of settled in the futureAUTHORIZEDPENDING9authorizedPending
AuthorizedThe transaction has been successfully authorized and is pending settlementAUTHORIZED10pending or authorized

For new sandbox accounts, you can expect authorized. For existing accounts, you can expect pending.
Auth OnlyThe payment is Auth Only and capturing is required to receive the funds. The transaction can also be voidedAUTHONLY11authOnly
DeclinedThe transaction was declinedDECLINED30declined
Risk HoldThe transaction is pending due to fraud risk identified by the processor. Typically, these transactions get resolved within one business day, however, you can also contact Nexio Customer Support to get assistance. RISKHOLD31riskHold
Fraud RejectThe transaction was declined by Kount prior to being submitted to the gatewayFRAUDREJECT32fraudReject
SettledThe transaction is settled. It can be refunded but not voidedSETTLED20settled
Void PendingThe payment is asynchronous and may receive a webhook notice with a status of voided in the futureVOIDPENDING39voidPending
VoidedThe payment has been voidedVOIDED40voided
ErrorAn error has occurredERROR50error

Echeck transaction status

StatusDescriptionNexio Dashboard StatusTransaction Service transactionStatusPayment Service transactionStatus
PendingThe transaction is pendingPENDING12pending
SettledThe transaction is settledSETTLED20settled
SubmittedThe payment was submitted to the bank for authorizationSUBMITTED13submitted
RejectedThe transaction was rejectedREJECTED33rejected

Transaction type (transactionType)

NameValue
Sale10
Refund20