> For the complete documentation index, see [llms.txt](https://docs.payengine.co/payengine-api-v2.5/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payengine.co/payengine-api-v2.5/transaction-monitoring/post-auth.md).

# Post Auth

## Perform a post auth

<mark style="color:green;">`POST`</mark> `https://<Platform-host>/transaction-monitoring/post-auth`

**Body**

<table><thead><tr><th width="304">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>transaction_id<mark style="color:red;">*</mark></td><td>string</td><td>Platform transaction ID. This typically is obtained through <code>/pre-auth</code> request before authorizing a payment</td></tr><tr><td>status<mark style="color:red;">*</mark></td><td>string</td><td>Authorization status <code>succeeded|failed</code></td></tr><tr><td>data</td><td>object</td><td>Authorization response returned by payment gateway/processor. Mandatory if status is "succeeded"</td></tr><tr><td>data.auth_code</td><td>string</td><td>Auth code from processor</td></tr><tr><td>data.response_code</td><td>string</td><td>Authorization response code. Generally a value in authorization response provided by gateways</td></tr><tr><td>data.response_message</td><td>string</td><td>Authorization response message</td></tr><tr><td>data.host_reference_number</td><td>string</td><td>A reference number from gateway/processor</td></tr><tr><td>data.host_response_code</td><td>string</td><td>If there's a response code provided by gateway</td></tr><tr><td>data.host_transaction_id</td><td>string</td><td>Transaction ID provided by processing host or gateway</td></tr><tr><td>data.address_verification_code</td><td>string</td><td>AVS result</td></tr><tr><td>data.cardholder_verification_code</td><td>string</td><td>CVV result</td></tr></tbody></table>

{% tabs %}
{% tab title="200 OK" %}

| Field Name                                            | Type   | Description                                                                                                                                                                                 |
| ----------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| processing\_status<mark style="color:red;">\*</mark>  | 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<mark style="color:red;">\*</mark> | string | The transaction status. If all rules pass it will be the status which was sent in the request                                                                                               |
| transaction\_id<mark style="color:red;">\*</mark>     | string | Platform generated unique transaction ID                                                                                                                                                   |
| triggered\_rules<mark style="color:red;">\*</mark>    | array  | List of configured rules and decisions                                                                                                                                                      |
| {% endtab %}                                          |        |                                                                                                                                                                                             |
| {% endtabs %}                                         |        |                                                                                                                                                                                             |

**Sample Request / Response**

{% tabs %}
{% tab title="Request" %}
**Example Sale Request**

```json
{
    "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"
    }
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "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"
        }
    ]
}
```

{% endtab %}
{% endtabs %}