# OneShot

Our OneShot solution will enable you to redirect the user to our checkout page where the user will see all the details for completing the deposit, and also will enable you to render the checkout page on your website (in the case of using Alternative Payment Methods).

<div align="center"><figure><img src="https://content.gitbook.com/content/f92vedEnowdVWbjM4Cmd/blobs/a8CpMcZeq3E9OqG45oQa/Checkout%20page.png" alt="" width="188"><figcaption></figcaption></figure> <figure><img src="https://content.gitbook.com/content/f92vedEnowdVWbjM4Cmd/blobs/1ITCRtcI1eML2tiXQ9yt/Checkout%20APM.png" alt="" width="188"><figcaption></figcaption></figure></div>

### Alternative Payment Methods world-class integration

Our OneShot integration allows you to render the checkout information on your website.

We will always send you the **`redirect_url`** parameter with the checkout hosted in our end.

But if you are looking for the best user experience, you can display the checkout in your site with your own custom design.\
You will receive in the response the required information in the **`metadata[]`**  object within the **`payment_info[]`**, such as QR codes, bar codes, banking copy/paste addresses, bank transfer details and more!

{% tabs %}
{% tab title="Example of a Pix deposit" %}

<pre class="language-json" data-title="QR code and Digitable Line"><code class="lang-json">{
    "checkout_type": "ONE_SHOT",
<strong>    "redirect_url": "https://payment-stg.depositcheckout.com/v1/checkout/eyJhbGciOiJIUzM4NCJ9.eyJqdGkiOiI1NzIyNjAwMiIsImlhdCI6MTc1MjUyMDk1NywiZXhwIjoxNzUzODE2OTU3LCJsYW5ndWFnZSI6InB0In0.50XjLnTTgaPowAHG7v8jP5jsXsUu6pp7mn5InR3UC-uFofNKVMOl9CEFNmH1FOOw/BR/IX/0341/31581",
</strong>    "iframe": true,
    "deposit_id": 301621986,
    "merchant_invoice_id": "postmanTest410953016",
    "payment_info": {
        "type": "VOUCHER",
        "payment_method": "IX",
        "payment_method_name": "Pix",
        "amount": 50.00,
        "currency": "BRL",
        "expiration_date": "2025-07-14 22:22:36",
        "created_at": "2025-07-14 19:22:36",
<strong>        "metadata": {
</strong><strong>            "payer_document": "84721238045",
</strong><strong>            "reference": 57226002,
</strong><strong>            "show_terms_conditions": true,
</strong><strong>            "payer_document_type": "CPF",
</strong><strong>            "qr_code": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAH0AAAB9AQAAAACn+1GIAAACN0lEQVR4Xt3UMZL3EBgHYJq4QjRxtaSJKySN0MQVopGrScMVaFjfX/abWewFVpV5Zoj39QOkn8ODPwUeTERa6oTfOexCSNdEwokiFXfog9D4tnvg5LnwL5CnXPCWhv4KmroIAPLHb5CUJuqW7iLf+6jAA6ze8V1LBXlY6ok6d/m/Hz/BQz7uHCD5+JV2IfFFnGwx0Dl9dCHcUjhz3MJOrLSwhuTsdKT0eJR4WbQGPxPlLhyHRSTVhfxlNnaYPO/6TGkgPfdtoB+pPI/PlBac3XDcsN4j2PuQz3lRfBiW3KU+hORuu83/yi+/rSFuYAbIIL0B9lm0hZXmnVHh2QSWLvgJcSSUO7FKogtJOmGPeHBGpeuCHwH2B8ePumAJTA1JBT5NRE/L40v5NXh4oRzqWz5ClXNpwc8TI+cwL/5NUA0jlEnxnH//vY8K4rpuM4Nmj4yVFtbgV6yCEMmZ3IQ+oLitDHqwru+UGiI55xWZPSmlcRdCvlzwJJrRWA6qAT8OKAgXh10+5bc1JL6NA5tHHOmbjxo81YAoS6VfrrJoDRE9UulhUXFinyvWwqIMFuq2AJbyGwjBYMvANrL3tw1ENkB3R5qunP8+oKAiG4nN5b/7qMCT/BRcYEL5xSk5rSHfj+dcicbPU+LQQH62Qhyx0Ayqko8aQtIb1URw9kaqBXFhCwBxgsNSfgvKHrdeZA7o53r0ICWz7UmeU3nYGkjXOgzbSu1eGtRA3ro0gB3Or0fpRw0/x9+GL70BgIv6XzUUAAAAAElFTkSuQmCC",
</strong><strong>            "digitable_line": "00020101021226850014br.gov.bcb.pix2563qrcodepix.bb.com.br/pix/v2/0a7702b2-c6b6-439a-9fd5-cc70c0c2353c5204000053039865802BR5925SOLAPA SERVICOS ADMINISTR6008CURITIBA62070503***6304AD87"
</strong><strong>        }
</strong>    }
}
</code></pre>

{% endtab %}

{% tab title="Example of a Spei deposit" %}

<pre class="language-json" data-title="CLABE reference"><code class="lang-json">{
    "checkout_type": "ONE_SHOT",
<strong>    "redirect_url": "https://payment-stg.depositcheckout.com/v1/checkout/eyJhbGciOiJIUzM4NCJ9.eyJqdGkiOiI1NzIyNjAxNiIsImlhdCI6MTc1MjUyMzgyOSwiZXhwIjoxNzUzODE5ODI5LCJsYW5ndWFnZSI6ImVzIn0.OKk8MNr5wGe6mt095nncss3Sbp1EC5rWhepaf4hjOetowsfc228dftfdcZJr5jHq/MX/SE/265/31581",
</strong>    "iframe": true,
    "deposit_id": 301622000,
    "merchant_invoice_id": "postmanTest43854702",
    "payment_info": {
        "type": "VOUCHER",
        "payment_method": "SE",
        "payment_method_name": "Spei",
        "amount": 945.84,
        "currency": "MXN",
        "expiration_date": "2025-07-17 20:10:29",
        "created_at": "2025-07-14 20:10:29",
<strong>        "metadata": {
</strong><strong>            "beneficiary_name": "D24",
</strong><strong>            "clabe": "646180287500315457",
</strong><strong>            "temporal_clabe": false,
</strong><strong>            "updated_clabe_flag": false,
</strong><strong>            "payer_name": "John Doe",
</strong><strong>            "instructions_alert": true
</strong>        }
    }
}
</code></pre>

{% endtab %}
{% endtabs %}

### **Hosted checkout**

{% hint style="warning" %}
Hosted flow is ***never*** recommended as a main deposit flow as it can impact directly on conversion rates.&#x20;
{% endhint %}

In the event that **not all mandatory data is sent** in the initial API call, the system will automatically trigger an intermediate flow known as the **Hosted flow**. This ensures the payment can still be completed.

* **What happens:** The API will return the parameter  **`checkout_type`**  with value **`HOSTED`** and a  **`redirect_url`**.
* **Required action:** You must redirect the user to that URL. On our hosted page, we will collect the missing information from the user before presenting them with the final checkout instructions in the same tab.

### Build the solution

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th></th><th></th><th></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Guide</strong></td><td>Follow detailed, step-by-step instructions and use our code examples to launch your integration with ease.</td><td><a href="../../create-deposits/credit-cards/basic-deposits/oneshot#deposit-with-oneshot-redirect">Create a deposit (credit cards)</a></td><td><a href="../create-deposits/bank-transfers-and-cash-vouchers">Create a deposit (APMs)</a></td><td><a href="../../create-deposits/credit-cards/3ds#oneshot-redirect">3DS</a></td><td><a href="../../create-deposits/credit-cards/installments#oneshot">Installments</a></td><td><a href="../../create-deposits/credit-cards/card-on-file#oneshot">Card-on-file</a></td><td><a href="../../create-deposits/credit-cards/subscriptions#oneshot">Subscriptions</a></td><td><a href="https://3883333839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff92vedEnowdVWbjM4Cmd%2Fuploads%2FA7IW5eo3ezhYpF9KGLxj%2FGuides.png?alt=media&#x26;token=d06326b3-d12e-4fbf-be42-00cf9a342168">Guides.png</a></td><td><a href="fragments-sdk/fragments-all-in-one">fragments-all-in-one</a></td></tr><tr><td><strong>API Reference</strong></td><td>Dive into the complete technical specifications for every API endpoint, including all parameters and response formats.</td><td><a href="https://app.gitbook.com/s/VNE8t2FopKfzgQzTjlBb/deposits-api/security-aspects">Security aspects</a></td><td><a href="https://app.gitbook.com/s/VNE8t2FopKfzgQzTjlBb/deposits-api/manage-payments/create-deposit">Create a deposit</a></td><td><a href="https://app.gitbook.com/s/VNE8t2FopKfzgQzTjlBb/deposits-api/payment-methods">Payment methods</a></td><td><a href="https://app.gitbook.com/s/VNE8t2FopKfzgQzTjlBb/deposits-api/currency-exchange/get-currency-exchange">Currency exchange</a></td><td></td><td></td><td><a href="https://3883333839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff92vedEnowdVWbjM4Cmd%2Fuploads%2FTiAuFTZ5RBhChHfdoE6W%2FAPI%20Reference.png?alt=media&#x26;token=05b7a0de-3c02-4139-967c-1394e5f8e2d3">API Reference.png</a></td><td><a href="https://app.gitbook.com/s/VNE8t2FopKfzgQzTjlBb/fragment-sdk/all-in-one">All-in-one</a></td></tr></tbody></table>