> 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/record-batch.md).

# Record Batch

## Trigger rules for batching

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

**Body**

<table><thead><tr><th width="304">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>merchant_id<mark style="color:red;">*</mark></td><td>string</td><td>The Platform system merchant ID</td></tr><tr><td>transaction_ids<mark style="color:red;">*</mark></td><td>array</td><td>List of transaction IDs in the batch</td></tr></tbody></table>

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

<table><thead><tr><th>Field Name</th><th width="155.15625">Type</th><th>Description</th></tr></thead><tbody><tr><td>processing_status<mark style="color:red;">*</mark></td><td>string</td><td>Overall processing status <code>allow|decline</code>. Decline generally means that one or more more rules that are configured do not allow this batch to proceed</td></tr><tr><td>triggered_rules<mark style="color:red;">*</mark></td><td>array</td><td>List of configured rules and decisions</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

**Sample Request / Response**

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

```json
{
    "merchant_id": "a9e30f16-1ef5-41e5-9ec2-c8e51a15b406",
    "transaction_ids": [
        "09536b98-d422-45e4-98b1-9068623ac509",
        "08ff1c3d-6bb2-4523-800d-f2530d88c11e"
    ]
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "processing_status": "allow",
    "triggered_rules": [
        {
            "rule": "batch-amount-below",
            "data": {
                "amount": "0.1"
            },
            "decisions": {
                "batch": "hold-batch-capture"
            },
            "result": false,
            "execution_time": 14,
            "decision": "allow"
        },
        {
            "rule": "batch-refunds-count",
            "data": {
                "count": "1"
            },
            "decisions": {
                "batch": "hold-transaction-payout"
            },
            "result": "1",
            "execution_time": 1,
            "decision": "hold-transaction-payout"
        }
    ]
}
```

{% endtab %}
{% endtabs %}
