Create Transaction


Last updated: 10/23/2025

Create Transaction

Creating a transaction is HatchPay's core feature.

picture

If you wish to save the details of a transaction before authorizing or capturing the payment, you can make the following request. Note that customer details and transaction details are both required for the transaction to be saved. POST /v1/payment-proxy/transactions

{
    "customer_details": {
        "first_name": "John",
        "last_name": "Doe",
        "address": {
            "street": "1 Auto Club Dr",
            "city": "Dearborn",
            "state": "MI",
            "postal_code": "42816"
        }
    },
    "transaction": {
        "payment_orchestrator_id": "7288e738-7a93-40ba-889f-3bdd37abh318",
        "transaction_items": [
            {
                "name": "Test Item",
                "amount": 100.00,
                "quantity": 1
            }
        ],
        "merchant_id": "merchant-123"
    },
    "business_unit_id": "79772e738-7a93-40ba-889f-3bdd37ab1d18",
    "metadata": {"foo": "bar"},
    "capture": false
}

Mark Transaction as an I2P Request

In the case that I2P is used, ensure that the I2P field is set to true, otherwise it may cause errors. It is set to false by default. POST /v1/payment-proxy/transactions

{
    "transaction": {
        // ... Your transaction details
    },
    // ...
    "i2p": true
}
Previous: Authentication Next: Auth + Capture Payment
Overview