Transaction Simulator Fields

post

https://developer-api.uat1.pcaasa.com/api/data.php

Listing of fields supported as input into the simulator.

Body Params

acquiringInstitutionCountryCode

string

Defaults to 840

Country where the payment instrument was used. No default but if NOT 840 exchangeRate is required.
length 3
numeric Only
valuerequired Yes

acquirerTraceData

string

Sending the acquirers trace data from an acquirer to an issuer alphanumericspace Only
maxlength 80

addressVerificationAddress

string

Authorize address in transaction
alphanumericspace Only
maxlength 100

addressVerificationZipCode

string

Authorize zipcode in transaction.
alphanumericspace Only
maxlength 25

amountSettlement

string

Amount of transaction in US cents adjusted by currency exchange
In Cents
maxLength 12

amountSettlementFee

int32

The cent amount of a fee from the acquiring or upstream processing. Combines with amountSettlementFeeType. In Cents
maxlength 8

amountSettlementFeeType

string

Single character of the fee type 0 or d for debit c for credit of a fee from the acquiring or upstream processing. Combines with amountSettlementFee.
feetype Yes
Values 0 = Debit
D = Debit
C = Credit

maxlength 1

amountTransaction

string

required

Amount always in US cents
In Cents
maxLength 12

amountTransactionFee

int32

The cent amount of a fee from the acquiring or upstream processing. Combines with amountTransactionFeeType.
In Cents
maxlength 8

amountTransactionFeeType

string

The cent amount of a fee from the acquiring or upstream processing. Combines with amountTransactionFee.
feetype Yes
Values 0 = Debit
D = Debit
C = Credit

maxlength 1
required No

AVSCode

string

alpha Only
Values A = Address matches, ZIP code does not
N = Nothing matches
R = Retry, system unable to process
U = No address data
Y = Address and 5-digit postal/ZIP code match
Z = 5-digit postal/ZIP code matches, street address does not match or street address not included
B = Retired Street address match for international transaction, but postal code not verified due to incompatible formats
C = Retired Street address and postal code not verified for international transaction due to incompatible formats
D = Retired Street address and postal code match for international transaction
G = Retired Address information not verified for international transaction
I = Retired Address information not verified
M = Retired Street address and postal code match
P = Retired Postal code match for international transaction, but street address not verified due to incompatible formats
S = Retired Not applicable

authorizationIdentificationResponse

string

Defaults to null

Identifies an pre-authorized transaction. Other names AIR and Auth Code.
alphanumeric Only
length 6

camResult

string

Identifies an pre-authorized transaction. Other names AIR and Auth Code.
alphanumeric Only
length 6

cardAcceptorNameLocationCountryCode

string

Defaults to US

Merchants 2 letter country abrreviation
maxLength 2

cardAcceptorNameLocationAddress

string

Merchant Name, Merchant Address, or Phone Number.
maxLength 22

cardAcceptorNameLocationCityName

string

Merchants City.
maxLength 12

cardAcceptorNameLocationStateName

string

erchants State abbreviation.
maxLength 2

currencyCodeSettlement

string

The settlement currency code is the fintechs or issuers locale ISO Numeric Currency Code.
numeric Only

currencyCodeTransaction

string

The transaction currency code is the merchants locale ISO Numeric Currency Code.
defaultValue 840
maxLength 3
numeric Only

cvv2Result

string

Values A = Address matches, ZIP code does not
M = CVV2 match
N = CVV2 No match
P = Not Processed
S = CVV2 should be on the card, but the merchant has indicated that CVV2 is not present
U = Issuer is not certified and/or has not provided Visa with the encryption keys

in cvv2Result
maxLength 1

exchangeRate

string

The rate at which the currency transaction is relative to currency settlement.

expirationMonth

string

required

MM Combines with expirationYear. This field contains the year and month the card expires. YYMM
maxlength 4
minlength 2
numeric Only

expirationYear

string

required

YY Combines with expirationYear. This field contains the year and month the card expires. YYMM
maxlength 2
minlength 1
numeric Only

fallbackIndicator

string

The Fallback Indicator enables your institution to determine whether a transaction was processed as fallback (processed as magnetic stripe even though the card and terminal are EMV capable).
Values 0 = Off
1 = On

numeric Only

forwardingInstitutionCountryCode

string

Defaults to 840

alphanumeric Only
defaultValue 840
length 3

merchantID

string

Unique Merchant ID assigned to the card issuer by the Merchant Acquirer or by DPS if by-pass routing is used for all funding activity.
alphanumeric Only
maxLength 18

merchantType

string

Defaults to 0000

length 4
numeric Only

messageType

string

ISO message types are used in various message flows between acquirers, issuers, and DPS.
Values 0100 = Advice
0120 = Auth
0200 = Financial
0220 = Financial
0420 = Reversal

messagetype Yes
numeric Only

partialAuthorizationIndicator

string

Y = Acquirer supports a partial authorization for transaction.
alpha Only
Values Y = Yes
N = No

maxlength 1

panEntryMode

string

The method by which the card number was entered
defaultValue 06
Values 00 = Unspecified
01 = Manual
02 = Magnetic stripe read
03 = Bar Code Read
04 = OCR coding read
05 = Integrated circuit (chip) card read
06 = Manual (key entered)
07 = Proximity payment Originated using VSDC rules
10 = Merchant has Cardholder Credentials on File
79 = PAN was manually entered
80 = PAN was entered via mag stripe
81 = From file
82 = Digitally stored/mobile/browser
84 = MICR read
90 = Full magnetic stripe read

length 2
numeric Only
panentrymode Yes
required No

pinData

string

boolean Yes
defaultValue Yes
description
Values 0 = Off
1 = On

referenceNumber

string

required

We use reference Numbers in our simulator. It is our internal identifying payment instrument identifier. alphanumeric = Yes gateway = pcaasa.piReferenceNumber isoFieldNumber = 2 maxlength = 50 minlength = 12 required = Yes

retrievalReferenceNumber

string

The Retrieval Reference Number is an identification number assigned to a transaction by the acquiring institution when the transaction is submitted for authorization.
alphanumeric Only

riskScore

string

Defaults to 01

A value that indicates the degree of risk associated with the transaction. Higher values indicate higher authorization risk.
blankleadingzero 2
blankmax 99
blankmin 1
length 2
numericspace Yes
required No
valuerequired Yes

securityCondition

string

Security concern level, such as fraud.
Values 0 = No security Concern
8 = CVV, dynamic CVV, or iCVV validated and valid
9 = CVV, dynamic CVV, or iCVV validated and invalid

numeric Only

systemTraceAuditNumber

string

The transaction indentifier given from the merchant.
alphanumericspace Only
maxlength 50

token

string

transactionType

string

required

The type of transaction
freetext Yes
Values 00 = Goods/Service Purchase
01 = Withdrawal/Cash Advance
02 = Debit Adjustment
06 = Traveler\’s check
10 = Money Transfer From
11 = Quasi-Cash and Scrip
12 = Cashback from Deposit
19 = Consumer Fee Collection
20 = Return (of goods)
21 = Deposits/Deposit Payments
22 = Credit Adjustment
24 = Check Deposit/Payment To without an Envelope
25 = Cash Deposit/Payment To without an Envelope
26 = Money Transfer To
28 = Prepaid card load/activation
29 = Consumer Funds Disbursement
30 = Available Funds Inquiry
31 = Balance Inquiry
33 = Account Verification
39 = Generic Account Balance Inquiry
40 = Cardholder Account Transfer
50 = Payment (3rd-party payment transaction, payee-initiated)
55 = Payment Receipt (3rd-party payment transaction, payer initiated)
58 = Transfer Payment (Intra-fin institution payment transaction)
59 = Payment enclosed
72 = Prepaid card activation
90 = PIN change
91 = Information inquiry
92 = Notification to bank

Response

200200