Get deposit status

Retrieve Deposit Status

get

Retrieve the status of a previously created deposit. This endpoint allows you to retrieve the status of a deposit request.

Path parameters

deposit_idintegerRequired

Directa24 deposit_id. It is obtained when creating the deposit.

Header parameters

Content-TypestringRequired

Media type of the body sent to the API. (Note: For GET, typically no request body)

Default: application/json

X-Datestring · date-timeRequired

ISO8601 Datetime with Timezone. Example: 2020-06-24T17:13:21Z

X-LoginstringRequired

Merchant X-Login API Key

AuthorizationstringRequired

Authentication signature hash

X-Idempotency-KeystringOptional

Unique idempotency key for ensuring that the same request is not processed more than once. (Typically for state-changing requests)

Responses

200

Deposit status successfully retrieved

application/json

user_idstringOptional

ID generated for the user on D24 end

deposit_idintegerOptional

ID of the deposit on D24 end

subscription_idinteger · nullableOptional

ID of the Subscription that triggered the deposit

invoice_idstringOptional

ID of the deposit on the merchant end

countrystring · nullableOptional

Country ISO code

currencystringOptional

Local currency code

local_amountnumber · float · nullableOptional

Amount in local currency

usd_amountnumber · float · nullableOptional

Amount in USD

amountnumber · float · nullableOptional

Amount in local currency (may appear in PENDING/CREATED status responses; prefer 'local_amount' or 'usd_amount' where available)

bonus_amountnumber · float · nullableOptional

The amount specified as bonus in the request

bonus_relativeboolean · nullableOptional

Specifies if the bonus_amount is absolute or relative. Only shown if bonus_amount is not null.

payment_methodstring · nullableOptional

Payment method code specified on the deposit request or selected by the user. Only shown if payment method is selected.

payment_typestring · nullableOptional

Type of the payment method. Only shown if payment method is selected.

statusstring · enumOptional

Status of the deposit

Possible values:

fee_amountnumber · float · nullableOptional

Fee of the deposit in the currency of your balance. Only shown if payment_method was sent or selected.

fee_currencystring · nullableOptional

Currency of your balance. Only shown if payment_method was sent or selected.

refundedboolean · nullableOptional

Shows if the deposit was refunded or not

current_payer_verificationstring · enum · nullableOptional

Shows if the current payer is the same person who creates the deposit. Only shown if not null.

Possible values:

completed_payment_method_codestring · nullableOptional

Payment method used by the client to complete the transaction

400

The deposit_id specified is not valid

application/json

401

Unauthorized access

application/json

404

The deposit_id specified could not be found

application/json

get

/deposits/{deposit_id}

HTTPcURLJavaScriptPython

GET /v3/deposits/{deposit_id} HTTP/1.1
Host: api-stg.directa24.com
Content-Type: application/json
X-Date: 2026-03-04T05:13:40.132Z
X-Login: text
Authorization: text
Accept: */*

{
  "user_id": "11",
  "deposit_id": 300004285,
  "invoice_id": "989409592",
  "country": "BR",
  "currency": "BRL",
  "local_amount": 53162,
  "usd_amount": 1000,
  "bonus_amount": 100,
  "bonus_relative": false,
  "payment_method": "VI",
  "payment_type": "CREDIT_CARD",
  "status": "COMPLETED",
  "payer": {
    "document": "17532655253",
    "document_type": "CPF",
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "Smith",
    "address": {
      "city": "Sao Paulo",
      "state": "SP",
      "street": "John Street 2453",
      "zip_code": "938475-234"
    }
  },
  "fee_amount": 2.5,
  "fee_currency": "USD",
  "refunded": false,
  "current_payer_verification": "UNMATCHED",
  "card_detail": {
    "card_holder": "John Smith",
    "brand": "Visa",
    "masked_card": "1234 56** **** 6789",
    "expiration": "2023-12",
    "card_type": "DEBIT",
    "transaction_result": "Transaction Approved"
  }
}