These parameters are used for products where StoreGUI=TF, TV, PS, PF, PV.
The PinlessRequest function type is used to perform activation or load supported by external service providers such as mobile phone carriers.
This is the first function type call of a two-step process: PinlessRequest and PinlessRequest2ndStep*. View flow diagram here.
*The second step is only needed if there is no <AuthorizationCode> value or <AuthorizationCode> is blank in PinlessRequest response.Most service providers use the two step process as it improves transaction reliability, especially during client-host communication abnormal scenarios. Thus, some service providers or PSIcomm may choose to use the one-step process depending on the requirements of individual service providers. Clients should support both one-step and two-step scenarios.
Note: If client does not receive a response for PinlessRequest within 30 seconds, client should consider transaction as not processed.
Certain parameters must be in all API calls, view all the parameters below:
This field is part of the Common Request Parameters.
The value for this call is PinlessRequest
GUI's are specified under each parameter. If not listed, then leave empty.
Receipt number from Station. If the actual receipt number contains more than five characters, the last 5 characters (from the right) are recorded in the e-Fresh table.
An unique number identifying the transaction request.
For topup send full phone number with area code.
This data should be sent only as numeric. If the user enters (604) 555-1212 it must be sent as 6045551212
For POSA cards send the full track data in this field (including Track 1 and Track 2)
Track1 and Track2 data separated by ~~ (two tildes)
Examples:
For card swiped with track1 and track2:
For card swiped with only track1:
For card swiped with only track2:
For Barcode scan, send the full barcode in this field
Example:
628478005527123456789012345678
The value to be loaded to the account, such as the topup amount in dollars.
ID of the clerk who sold the product.
6 character code identifying product. List of codes is in the product file.
011 (Manual)
021 (Card swipe)
031 (Barcode scan)
041 (Online)
Store the client's reconciliation reference. It will be sent in the request packet to PSIcom.
(See product pages for customized examples)
<RequestXml>
<Type>PinlessRequest</Type>
<TerminalId>Assigned</TerminalId>
<Password>Assigned</Password>
<ReceiptNo>12345</ReceiptNo>
<Amount>25</Amount>
<ClerkId>bsmith</ClerkId>
<AccountNo>11999990000</AccountNo>
<RefNo>67141630</RefNo>
<ProdCode>AMVGCE</ProdCode>
</RequestXml>
Use the Common Response Fields for many of the standard fields.
Certain fields are returned from all API calls, view all the fields below:
GUI's are specified under each parameter. If not listed, then do not use.
PSInet generated unique transaction number.
Authorization code for successful transaction.
Important:
If this field is blank in “PinlessRequest”, Client should proceed with sending “PinlessRequest2ndStep”.
If this field is not blank and StatusCode=0, consider transaction success, print receipt, do not send “PinlessRequest2ndStep”.
This field may be blank in “PinlessRequest2ndStep” (consider success).
For topup send full phone number with area code.
This data should be sent only as numeric. If the user enters (604) 555-1212 it must be sent as 6045551212
TF, TV- Publicly viewable representation of account number. Masked card/account/phone number to display on voucher as customer reference.
TF, TV-Masked phone number
PS,PV-Masked card/account/phone number to display on voucher as customer reference.
For Amazon RTR
If customer's phone is unregistered, the <Custom1> field contains a label, <Custom2> and <PinSerial> contains a claim code.
e.g.
<Custom1>This is your Claim Code:</Custom1>
<Custom2>JYPF-QHNBNQ-DQAF</Custom2>
<PinSerial>JYPF-QHNBNQ-DQAF</PinSerial>
If customer's phone number is registered, topup will take effect immediately. no claim code is needed. <Custom2> and <PinSerial> contain the masked Amazon account registered phone number.
e.g.
<Custom1>nn has been added to your</Custom1>
<Custom2>Amazon account XXXXXX0000</Custom2>
<PinSerial>Amazon account XXXXXX0000</PinSerial>
XXXXXX0000 is customer's masked phone number.
Message from provider to display on voucher for customer.
(See product pages for customized examples)
<ResponseXml>
<StatusCode>0</StatusCode>
<StatusDescription>Transaction Pending</StatusDescription>
<TransNo>1110005412370</TransNo>
<AuthorizationCode />
<AccountNo>11999990000</AccountNo>
<AdditionalInfo>
<Item fs="5">0.00</Item>
<Item fs="17">0</Item>
<Item fs="18">XXXXXXXXXXXXXXX8864</Item>
<PinData>
<Pin />
<Custom1>XXXXXXXXXXXXXXX8864</Custom1>
<Custom2 />
<PinSerial />
<PinBatch />
<ExpiryDate />
</PinData>
<Custom1>XXXXXXXXXXXXXXX8864</Custom1>
<Custom2 />
</AdditionalInfo>
<MerchantId>PSITESTSTORE</MerchantId>
<Company>PSI Convenience</Company>
<CompanyCity>Port Moody</CompanyCity>
<CompanyPhone>(604) 555-5555</CompanyPhone>
<CompanyDbaName>PSI Convenience Mart</CompanyDbaName>
<TransDate>2019-02-01</TransDate>
<TransTime>13:57:02</TransTime>
<ProductVer>0450036</ProductVer>
<PromoVer />
<SoftVer />
<InvoiceNumber />
</ResponseXml>