IPWorks EDI 2020 Python Edition

Questions / Feedback?

verify_receipt Method

Verifies an asynchronous MDN receipt.


def verify_receipt() -> None: ...


VerifyReceipt verifies the receipt in mdn_receipt against original_content_mic, message_id and the preferences specified in mdn_options. The method operates similarly to post: After the method finishes, the mdn_receipt, ReceiptSigningProtocol, and receipt_signer_cert properties will be populated with the appropriate values.

The method operates synchronously, and will throw an exception if any errors or warnings occur. Errors might include a failure to decrypt or authenticate the receipt, the absence of an MDN when one was requested, TCP/IP errors, or any errors reported by the server in the MDN. Warnings might include the return of an unsigned receipt when a signed receipt was requested, or other warnings reported by the server in the MDN.

If an exception is thrown the error code will correspond to the severity of the warning or error, allowing client software to determine whether or not to accept the reply. If multiple errors occur, the exception will return a special error code, and the error message will contain a line for each error's code and description; i.e. "423: Failed to authenticate sender". If the error(s) is/are not fatal processing will not be interrupted, and the relevant properties will be populated as normal.

This method should be used to verify receipts received asynchronously; i.e., not in the HTTP reply to a POST. When posting, asynchronous MDN delivery may be requested by setting mdn_delivery_option.

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks EDI 2020 Python Edition - Version 20.0 [Build 8162]