Standard Withdrawal

Event Key

ootb_withdrawal

This event should be sent when a user conducts a withdrawal.

Event KeyEvent NameType
ootb_withdrawalOOTB WithdrawalSimple event

Event Structure

The mandatory properties (tenant, timestamp, event, and customer) are required for all events and documented in detail on the Mandatory Properties page. Below is the JSON structure for the context-specific properties of the Standard Withdrawal Event:

{
  "context": {
        "ootb_transaction_id": "11228836059",
        "ootb_withdrawal_timestamp": "2022-04-09T20:01:51.887000Z",
        "ootb_start_balance": 200.00,
        "ootb_withdrawal_amount": 50.00,
        "ootb_withdrawal_method": "bank_transfer",
        "ootb_withdrawal_status": "pending",
        "ootb_language": "en",
        "ootb_country": "US",
        "ootb_platform": "iOS",
        "ootb_channel": "mobile",
        "ootb_brand": "skin123",
        "ootb_license": "licenseXYZ"
    }
}

Parameters

📘

Events-based Integration (EBI): parameter classification

The Events-based Integration column shows how each parameter is treated when you onboard using an Events-based Integration:

  • Mandatory — required for the event to be ingested and processed correctly.
  • Mandatory if required for the execution channel integration — required only when the relevant execution channel (e.g., email, SMS, push, WhatsApp) is part of your integration.
  • Enrichment- used for out-of-the-box attribute — not required, but when provided it powers an Optimove out-of-the-box attribute.
  • Optional — accepted and stored when provided; not required and not tied to an OOTB attribute.
Parameter KeyParameter NameTypeDescriptionEvents-based Integration
ootb_transaction_idTransaction IDString/NumberUnique identifier for the transaction that resulted in the balance update.Mandatory
ootb_withdrawal_timestampWithdrawal TimestampStringISO 8601 datetime of the withdrawal request.Mandatory
ootb_start_balanceStart BalanceNumberThe user’s balance before the withdrawal.Optional
ootb_withdrawal_amountWithdrawal AmountNumberThe amount of the withdrawal.Enrichment- used for out-of-the-box attribute
ootb_withdrawal_methodWithdrawal MethodStringThe method used for the withdrawal (e.g., bank_transfer).Optional
ootb_withdrawal_statusWithdrawal StatusStringThe status of the withdrawal (e.g., pending).Mandatory
ootb_languageLanguageStringThe language preference (e.g., en).Optional
ootb_countryCountryStringThe country code (e.g., US).Optional
ootb_platformPlatformStringThe platform used (e.g., iOS, Android).Enrichment- used for out-of-the-box attribute
ootb_channelChannelStringThe channel used for the withdrawal (e.g., mobile, web).Optional
ootb_brandBrandStringThe skin ID associated with the withdrawal.Optional
ootb_licenseLicenseStringThe license string associated with the withdrawal.Optional