OneShot

Deposit with OneShot redirect

1

Create a deposit request

You will need to create a deposit request to our OneShot API, taking into care the following considerations:

• sending all the mandatory payer information

• indicating that is a credit/debit card payment by sending CC as payment_method

Example request

curl -L \
  --request POST \
  --url 'https://api-stg.directa24.com/v3/deposits' \
  --header 'Content-Type: application/json' \
  --header 'X-Date: 2025-07-17T13:13:15.442Z' \
  --header 'X-Login: text' \
  --header 'Authorization: text' \
  --data '{
    "invoice_id" : "1000000001",
    "amount": "1000",
    "country": "MX",
    "currency": "MXN",
    "payer": {
        "id": "11",
        "document": "CURP4321TEST",
        "first_name": "Ricardo",
        "last_name": "Carlos",
        "email": "[email protected]"
    },
    "payment_method": "CC",
    "client_ip": "123.123.123.123",
    "back_url": "https://www.mercahnt.com/deposit_cancelled",
    "success_url": "https://www.merchant.com/deposit_completed",
    "error_url": "https://www.merchant.com/deposit_error",
    "notification_url": "https://www.d24.com/d24/notify"
    "logo": "https://www.merchant.com/merchant-logo.png",
}'

Example response

{
    "checkout_type": "ONE_SHOT",
    "redirect_url": "https://pay-stg.depositcheckout.com/validate/W9H0knNO7iu14F2nMe1Dtv6eMKJw2yvx",
    "deposit_id": 301623200,
    "user_id": "11",
    "merchant_invoice_id": "1000000001",
    "payment_info": {
        "type": "CREDIT_CARD",
        "payment_method": "CC",
        "payment_method_name": "Generic CC payment method",
        "amount": 1000.0,
        "currency": "MXN",
        "expiration_date": "2025-07-17 18:02:28",
        "created_at": "2025-07-17 17:42:26"
    }
}

2

Open the redirect_url in a new tab

In the response you will receive the redirect_url where the user should be sent in order to visualize the credit card checkout hosted on our systems.

Note that you can include your brand logo in our checkout!

You can either send it via API or define it statically within the Merchant Panel.

3

Retrieve the Deposit final status

Everytime that the deposit changes it's status, you will receive a webhook notification with the deposit_id for you to retrieve the status.

{
  "deposit_id": 301623200
}

For more information on this point visit Notifications.