Invite2Pay (I2P) lets you collect a payment without ever handling the customer’s card details yourself. The flow has three stages:

1. You initiate the transaction. You create a transaction marked for I2P and choose how the customer is contacted — SMS or email. HatchPay generates a single-use, time-limited invite link and delivers it to the customer.

2. The customer completes payment. The link opens a secure payment page showing the transaction’s line items. The customer enters their payment details directly with the gateway and submits.

3. The payment is processed. The customer’s payment is authorized (and optionally captured). Both you and the customer are notified of the result, so any failure — such as an incorrect card — can be resolved quickly.

Creating the I2P Transaction

Start the flow by creating a transaction with i2p set to true and a communication_type of SMS or EMAIL. Include the customer’s contact details, the payment_orchestrator_id, the business_unit_id, and the line items being sold.

POST /v1/payment-proxy/transactions

{
    "customer_details": {
        "first_name": "John",
        "last_name": "Doe",
        "email": "john.doe@example.com"
    },
    "transaction": {
        "payment_orchestrator_id": "7288e738-7a93-40ba-889f-3bdd37ab1d18",
        "transaction_items": [
            { "name": "Test Item", "amount": 100.00, "quantity": 1 }
        ]
    },
    "business_unit_id": "79772e73-7a93-40ba-889f-3bdd37ab1d18",
    "i2p": true,
    "communication_type": "EMAIL"
}

The response includes an invite_link. By default HatchPay sends this link to the customer for you; the response also returns it so you can display or relay it yourself. For the full request reference, see Create Transaction.

Customer View

When the customer opens the link, they see the transaction’s items and a secure form for their payment details. If the business unit has configured I2P branding, the page shows your business unit’s name and logo instead of the gateway’s defaults. On a successful payment, both you and the customer receive confirmation; if the payment is declined, the customer is prompted to try again. Note that I2P is available only when the business unit’s payment gateway is Tempus.