Post Auth

Use this API to record the result of the authorization.

Perform a post auth

POST https://<PayEngine-host>/transaction-monitoring/post-auth

Body

Name	Type	Description
transaction_id*	string	PayEngine transaction ID. This typically is obtained through /pre-auth request before authorizing a payment
status*	string	Authorization status succeeded|failed
data	object	Authorization response returned by payment gateway/processor. Mandatory if status is "succeeded"
data.auth_code	string	Auth code from processor
data.response_code	string	Authorization response code. Generally a value in authorization response provided by gateways
data.response_message	string	Authorization response message
data.host_reference_number	string	A reference number from gateway/processor
data.host_response_code	string	If there's a response code provided by gateway
data.host_transaction_id	string	Transaction ID provided by processing host or gateway
data.address_verification_code	string	AVS result
data.cardholder_verification_code	string	CVV result

200 OK

Field Name	Type	Description
processing_status*	string	Overall processing status allow|decline. This is generally the final result of the configured post-auth rules and partners can decide to void the transaction or keep it for settlement.
transaction_status*	string	The transaction status. If all rules pass it will be the status which was sent in the request
transaction_id*	string	PayEngine generated unique transaction ID
triggered_rules*	array	List of configured rules and decisions

Sample Request / Response

Request

Example Sale Request

{
    "transaction_id": "391bc6b7-3db5-454d-b69a-a41bb226a16c",
    "status": "succeeded",
    "data": {
        "auth_code": "A002",
        "response_code": "OK",
        "response_message": "Successful",
        "host_reference_number": "5242445517",
        "host_response_code": "00",
        "host_transaction_id": "41246553",
        "address_verification_code": "Z",
        "cardholder_verification_code": "N"
    }
}

Response

{
    "decisions": [
        "block-merchant"
    ],
    "processing_status": "allow",
    "transaction_status": "succeeded",
    "transaction_id": "391bc6b7-3db5-454d-b69a-a41bb226a16c",
    "triggered_rules": [
        {
            "rule": "transaction-amount-greater-than",
            "data": {
                "amount": "0.5"
            },
            "decisions": {
                "postauth": "block-merchant"
            },
            "result": true,
            "execution_time": 2,
            "decision": "block-merchant"
        }
    ]
}