RPOS will call this to purchase an item that is staged in CPCItems table, using CPCItems_Seq as the identifier. Using Type, this call can be use as a Query, where the same response given for the Purchase call will be re-sent.
Header Authorization : Bearer + JWT - Obtained using the JWT Endpoint - See Security section
Root: <PSInetRequest>
<CPCItems_Seq> - Unique value for each request from Canada Post (across all RPOS terminals)
<Type> - Options are Purchase or Query.
<PurchaseRefNo> - RPOS generated unique string for this transaction, up to 20 characters.
<PaymentMethod> - Options are: Cash, Debit or Credit
<EODNumber> - End of Day batch number
Root: <PSInetResponse>
<ResponseCode> - (More details and methods to trigger different codes)
"0" - Success
"2" - Failed
"9" - System error
<Description> - Text description of the ResponseCode
English
French
<TransNo> - Unique PSInet transaction number for this response
<AccountNumPublic> - Publicly viewable, non-private product serial number or masked account number. Can be printed an receipt or voucher.
<AccountNumPrivate> - Full product serial number or account number for reconciliation.
<DateSold> - Date and time of this response in local time
<ProdName> - Product name
<CPCItems_Seq> - Echoed from the product request
<EODNumber> - Echoed from the product request
<ItemStatus> (this field is used by the PSI Emulator, RPOS does not need to read or act on this field)
"P" - Successfully completed/purchased
"J" - In progress/unknown (Has not been staged)
"S"- Staged, added to the RPOS cart
"C" - item cancelled by clerk
"F" - item not available, or card load not allowed
"L" - Purchase In progress / (unknown if taken to long)
"N" - failed or no
"M" - Start void process
"T" - Void Failed
"X" Successfully Voided
<Voucher> - PNG Image - Base64 encoded string
<ReceiptText> - This text is to be place on the main receipt under the itemized line.
<ln>Line 1</ln>
<ln>Line 2</ln>
<ItemStatusMessage> - (Debug message, this field is used by PSI, will not exist in production.)
Amount -
Fee
ArticleNumber -
TaxCode
AgentCommission
Voidable
RPOS will call this to void an item that has been purchased, using CPCItems_Seq as the identifier. Return not supported. Same day voids only.
Header Authorization : Bearer + JWT - Obtained using the JWT Endpoint - See Security section
Root: <PSInetRequest>
<CPCItems_Seq>
<Type> - Void
Root: <PSInetResponse>
<ResponseCode>
"0" - Void Successful (or void was not needed)
"2" - Unable to Void
"9" - System error
<Description> - [Void Successful, Void Failed, Unable to Void , System error]
<VoidTransNo> - Unique PSInet transaction number for this response
<CPCItems_Seq>
<ItemStatus> - (this field is used by the PSI Emulator, RPOS does not need to read or act on this field)
"M" - Start void process
"T" - Void Failed
"X" - Void Successful (or void was not needed)
<DebugMessage> - (this field is used by PSI)
ProdName
DateVoided