Reprinting transaction receipts

The CloverConnector#DisplayReceiptOptions method causes the Clover device to show the receipt selection screen. This allows the merchant to reprint a receipt for a transaction if needed for recordkeeping or other purposes.

The DisplayReceiptOptionsRequest passed in to the call must include a specific combination of ID values depending on the type of transaction.

PaymentId

OrderId

RefundId

CreditId

Payment

:white-check-mark:

:white-check-mark:

Full refund

:white-check-mark:

:white-check-mark:

:white-check-mark:

Partial refund

:white-check-mark:

:white-check-mark:

:white-check-mark:

Manual refund (credit)

:white-check-mark:

:white-check-mark:

Payment Receipts

The receipt for any type of payment can be reprinted by calling CloverConnector#DisplayReceiptOptions with a PaymentId and OrderId.

function showReceiptsPayment() {
    var dror = new DisplayReceiptOptionsRequest();
    dror.setPaymentId(this.payment.PaymentId);
    dror.setOrderId(this.payment.OrderId);
    this.cloverConnector.displayReceiptOptions(dror);
}

Refund and Credit Receipts

Clover supports three types of refunds:

  • Full payment refunds
  • Partial payment refunds
  • Manual refunds (credits)

For example, if you want to show the receipt options for a full refund, call CloverConnector#DisplayReceiptOptions with a PaymentId and OrderId, as well as the RefundId of the transaction you want to reprint.

function showReceiptsRefund() {
    var dror = new DisplayReceiptOptionsRequest();
    dror.setPaymentId(this.payment.PaymentId);
    dror.setOrderId(this.payment.OrderId);
    dror.setRefundId(this.payment.RefundId);
    this.cloverConnector.displayReceiptOptions(dror);
}

For a partial refund, you also need to include a PaymentId, OrderId, and the RefundId of the transaction.

function showReceiptsPartialRefund() {
    var dror = new DisplayReceiptOptionsRequest();
    dror.setPaymentId(this.payment.PaymentId);
    dror.setOrderId(this.payment.OrderId);
    dror.setRefundId(this.payment.RefundId);
    this.cloverConnector.displayReceiptOptions(dror);
}

When a manual refund is processed, a CreditId is generated that uniquely identifies the transaction. To reprint the receipt for this kind of refund you need to include the OrderId and the CreditID.

function showReceiptsManualRefund() {
    var dror = new DisplayReceiptOptionsRequest();
    dror.setOrderId(this.payment.OrderId);
    dror.setCreditId(this.payment.CreditId);
    this.cloverConnector.displayReceiptOptions(dror);
}

Did this page help you?