NET SDK

Signature Approved Transaction

Eventhough we do not allow CVM Signature in Europe, we still have to accept those transactions made with cards from other parts of the world.

Edit "Signature Approved Transaction" on GitHub

The Flow

The flow of a CVM signature transaction always needs to be implemented and works the same regardless if the default or client only implementation is made. The difference from a normal transaction is that the sale system first gets a PrintRequestEventCallback with the merchant receipt that needs to be signed. Then the sale system will get a callback to ConfirmationHandler with a text to be displayed to the operator in a YES/NO dialog box. The callback itself has a parameter called callback which must be used to deliver an answer true or false. When that callback has been called the sale system will get the final PaymentRequestResult.

The following illustrates the flow when using async call

sequenceDiagram
participant POS
participant NetSDK

POS->>+NetSDK: PaymentRequestAsync
NetSDK->>POS: EventCallback PrintRequestEventCallback
Note over POS: Print the merchant's receipt
NetSDK->>POS: ConfirmationHandler 
Note over POS: Display message.<br>Let operator respond by<br>approving or refusing
alt
  Note over POS: Signature accepted
  POS->>NetSDK: callback(true)
else
  Note over POS: Refuse signature
  POS->>NetSDK: callback(false)
end
NetSDK->>-POS: PaymentRequestResult
Note over NetSDK: Success or Failure depending on above<br>call. Always print the customer receipt

You must respond by using the callback and you must not call Abort.

If synchronous calls are used the flow is the same but the PaymentRequestResult will appear in the SyncRequestResult callback.

The flow works for both Client Only mode and when implementing the default mode. When Client Only mode, the SDK will fake the print- and input- requests from the terminal to make the flow identical. However when refusing the signature in Client Only mode a ReversalRequest is made and the customer receipt will indicate that the transaction was cancelled.