Create Transaction
Last updated: 10/23/2025
Create Transaction
Creating a transaction is HatchPay's core feature.
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
}