Payment with Documents/Reciepts

Payment Process Combined with Automatic Documents

The process will include 3 methods -

1. CreateSale - Creating a Sale.
2. ChargeSimple - Make the charge (Create a transaction).
3. CompleteSale - Connect the Charge and the Sale together and produce an automatic document/receipt.

🚧

Note

• This Process requires a payment pages service in iCredit account.
• Making charges will require an internet permissions on the merchant terminal.
• CreateSale method should be in the first step - in order to check the customer and items information.(before making the charge)
• The automatic Document/Receipt will include the charge voucher with all the transaction info.

CreateSale

The method request parameters will include:

• Customer details for the document/receipt
• Items array - to calculate the charge amount and display on the document items list (in case of receipt it will not include the items).
• Other payment settings available - sale type, recurring settings, etc.

The method response:

• 'TotalAmount'- The value in the sale response will return as X 100 (15.5=1550.0).
• 'SalePrivateToken' & 'SaleToken' - The Sale identifiers that return in the response.

🚧

Save the SaleToken Value to use it in method CompleteSale method request.

CompleteSale

The method request parameters will include 2 mandatory values:

'SaleToken' - The value that received in CreateSale method response.

'CustomerTransactionId' - The value that received in ChargeSimple method response.

The method response will include:

• The status of the action that connects between the transaction and the sale.
• The document/receipt info and URL.

Producing a Document/Receipt separately After a Charge

After using ChargeSimple in order to make the charge, in order to produce a document/Receipt it is possible to use one of the methods:

Document.New - Producing a new document

Receipt.New - Producing a new Receipt

🚧

Note:

• This process will require only direct payment service and Rivhit account.
• No need for internet permissions on the merchant terminal.
• Both will produce a simple document/receipt without the charge voucher on it.
• In order to send the specific payment values (credit card, voucher number etc.) use this guide - Payment Type Values.
• This document/receipt will not appear on iCredit reports.