with id `payment_form_container`, this can look like: ```html ... ...

``` {% endtab %} {% endtabs %} ## Handling payment response Whenever a payment is performed by a shopper through an HPP or IFRAME, it will result in a payment confirmation page. If a `return_url`is specified by the merchant when creating a Checkout, the customer will be redirected to the `return_url` after the confirmation page. Depending on the result, the redirection would include `transaction_id` if a transaction is created and/or **error\_code** if an error has occurred. The redirection URL for a successful transaction would look like this: ```json https://merchantwebsite.com/order/1234?transaction_id={transaction_id}&checkout_id={checkout_id} ``` Both success and failure Checkout outcomes result in the customer being redirected to the confirmation page/ failed payment page. If a `return_url` is used, the customer will be redirected to that specific page afterwards. {% hint style="info" %} The `return_url` you have provided needs to link the Checkout ID with the order on your system, to be able to reliably handle the response. {% endhint %} **Example**: * Customer places order and your system generates order ID `1234` * You create a Checkout for this order and set the `return_url` to `https://merchantwebsite.com/order/1234` * The API responds with `id` and `url`. You ensure that this `id` is linked to the `order_id` in your system, so that you can match them later. * You redirect the customer to the `url` * The customer completes the Checkout and is redirected to the `return_url` with query string parameters appended to it by Verifone. For a successful transaction, the final redirection URL would look like: * Because your return URL uniquely identifies the `order_id`, you know which checkout belongs to the order * To determine the outcome, you can read back the Checkout by calling the `GET /v2/checkout/{checkout_id}` using the `id` of the Checkout stored earlier and inspect the `events` field {% hint style="info" %} To ensure that the redirection request was not tampered with, always check that the `transaction_id` received as a query parameter in the redirection matches the `transaction_id` property of the retrieved Checkout. If those are not matching, this is an indication of either an incorrect integration, that the redirection to your `return_url` did not originate from Verifone, or the `transaction_id` was tampered with. {% endhint %} * You can now store the `transaction_id` value together with the order `1234` in your system to link the two together ## Read Checkout To determine the outcome of the Checkout, the merchant should query the checkout by doing a Server-to-Server call to **GET /v2/checkout/{checkout\_id}**. In the response, they would find the `events` field. **Successful** transaction response: ```json [ ... { "type": "TRANSACTION_SUCCESS", "id": "f2041250-4fc2-4b3a-bc94-651ba099541a", "timestamp": "2020-07-08T12:42:37.974Z", "details": { // varies per payment method } } ... ] ``` **Failed** transaction response: ```json [ ... { "type": "TRANSACTION_FAILED", "id": "f2041250-4fc2-4b3a-bc94-651ba099541a", "timestamp": "2020-07-08T12:42:37.974Z", "details": { // varies per payment method } } ... ] ``` The exact list of event types and the keys in the **details** object vary per payment method. **Next steps** * [Card payments](/online-payments/mobile-sdks/card-payments.md) * [Card payments with 3-D Secure](/online-payments/checkout/accepting-payments/3d-secure-payments.md) * [Alternative payment methods](/online-payments/advanced-payment-methods-apms.md) * [Theming](/online-payments/checkout/theming.md) ## APIs used to update the transaction status Actions that can be performed on a transaction after it was initiated are listed in the [Verifone eCommerce API](/api-reference/open-api-references/ecommerce.md). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.verifone.com/online-payments/checkout/accepting-payments.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.