Handle the Print Receipt callback

Requirements

Adyen provides certified receipts that are as short as possible while still meeting scheme requirements. For custom receipts, take care to include all data elements required by certification. Any issues that arise from not including these required data elements are at your own liability. 

Card schemes have very specific requirements on what should be included on a receipt. These requirements differ per scheme and country/region, and can change. Receipts generated by Adyen have been certified as compliant by the card schemes that we support.

Card schemes will occasionally visit live stores to verify that receipts being generated are fully-compliant.

Implement the print receipt callback

Implement the tender_print_receipt_CB, assign to the function pointer status_tender_print_receipt and invoke this by passing the ReceiptHandler tender option.  For more information on how to do this, see Implement callbacks with register_device_request.

void tender_print_receipt_CB(receipts_strct * status_tender, ped_device_info * ped_state, void * echo_struct){
    app_context_t * sPOS = (app_context_t *)echo_struct;
    //TODO: store the receipts somewhere
    //ADYLibraryResult result =
    confirm_print_receipt(sPOS->terminal_id, sPOS->tender_reference, 1);
}

Invoke the print receipt callback

Specify ReceiptHandler as a tender option to invoke the print receipt callback and print on the POS. If the ReceiptHandler tender option is not specified and the PED does not have a printer, the transaction fails in violation with certification requirements.

Receipts might need to be printed multiple times. For example, when an approved receipt is printed to allow the shopper to sign. If the merchant does not approve the signature, after checking it with the signature on the back of the card, a cancel receipt needs to be printed. So, each invocation of the print receipt callback generates a new receipt. 

Handle the print receipt callback

The tender_print_receipt_CB is returned when a receipt on the PED needs to be printed. Receipt printing is a part of scheme certification. The receipt is passed to the POS when the PED does not include a printer, or where receipts must be archived or emailed. In this case, the POS must confirm that the receipt was received and printed. Create this function and assign to the function pointer status_tender_print_receipt.

Parameters

Confirm Print Receipt Function

Respond to the print receipt callback using the confirm_print_receipt function

Parameters

Code example

confirm_print_receipt(char * terminal_id, char * tender_reference, boolean confirmation);