Global Account

Global Account New

Triggered when a deposit is received via Global Account, pending settlement to wallet balance.

Description

Sent when a new deposit is received in a global account but hasn't yet been settled to the wallet balance.

📦 Event Details

id string

Unique event identifier.

name string

Event name: ga.new.

account_id string

Unique identifier of the account associated with the transaction.

data object

Event payload containing transaction details.

amount double

Transaction amount.

ccy string

Transaction currency (3-letter ISO-4217 code).

transaction_type string

Type of transaction. Value: DEPOSIT.

process_status string

Current processing status.
Status flow:
NEW → PENDING → SETTLED. May transition to FAILED if settlement fails.

settlement_info object

Settlement-related information.

beneficiary_account_number string

Beneficiary account number.

beneficiary_name string

Name of the beneficiary.

payer_name string

Name of the payer.

created_at string

ISO 8601 timestamp indicating when the event was created.

version string

API version associated with the event.

Request Body Example

{
  "id": "b19b2529-3f6c-4a79-b575-c595a0043985_ga.new",
  "name": "ga.new",
  "account_id": "acct_hUiVInamMd68NDDm5VVmyA",
  "data": {
    "amount": 100.0,
    "ccy": "SGD",
    "transaction_type": "DEPOSIT",
    "process_status": "NEW",
    "settlement_info": {
      "beneficiary_account_number": "88520209770",
      "beneficiary_name": "Zoqq (Singapore) Pte Ltd",
      "payer_name": "JS"
    }
  },
  "created_at": "2025-04-28T12:06:45+0000",
  "version": "2025-02-14"
}

Balance Collection

Triggered when wallet balance increases due to a settled deposit from Global Account.

Description

Sent when funds from a Global Account deposit have been successfully settled and added to the wallet balance.

📦 Event Details

id string

Unique event identifier.

name string

Event name: balance.ga.top_up.

account_id string

Unique identifier of the account whose balance was updated.

data object

Event payload containing balance top-up details.

ccy string

Currency of the transaction (3-letter ISO-4217 code).

amount double

Top-up amount credited to the account.

balance double

Updated account balance after the top-up.

type string

Transaction type. Value: DEPOSIT.

transaction_reference object

Reference details associated with the deposit transaction.

deposit_id string

Unique identifier of the deposit transaction.

global_account_id string

Global account identifier linked to the deposit.

payer_name string

Name of the payer.

payer_bank_name string

Name of the payer’s bank.

reference string

Client-provided reference for the transaction.

created_at string

ISO 8601 timestamp indicating when the balance update occurred.

created_at string

ISO 8601 timestamp indicating when the event was created.

version string

API version associated with the event.

Request Body Example

{
  "id": "d5429604-0f3e-3e60-9058-46f44e4552f5",
  "name": "balance.ga.top_up",
  "account_id": "acct_hUiVInamMd68NDDm5VVmyA",
  "data": {
    "ccy": "SGD",
    "amount": 100,
    "balance": 100,
    "type": "DEPOSIT",
    "transaction_reference": {
      "deposit_id": "b19b2529-3f6c-4a79-b575-c595a0043985",
      "global_account_id": "2a5f4d31-e290-4192-9746-61c862ba2d27",
      "payer_name": "JS",
      "payer_bank_name": "SBI"
    },
    "reference": "123",
    "created_at": "2025-04-28T12:06:45+0000"
  },
  "created_at": "2025-04-28T12:06:45+0000",
  "version": "2025-02-14"
}