Topup schema

Property Type Description
id
string

Unique identifier for the topup request.

amount
number double

Amount in USD intended to be added to your organization’s balance.

processing_fee
number double

Amount of the processing fee for the topup (typically reserved for credit card topups).

funding_source_id
string

ID of the funding_source object used for this topup.

status
string

Status of the topup

Status Description
created The topup is processing (and may be under review).
fully_credited The funds have been added to the balance.
reversed The topup was credited, but then reversed due to a chargeback or ACH return.
rejected The topup was rejected by an admin.

created_at
string date-time

Timestamp indicating when the topup object was created (when the request was made).

fully_credited_at
string date-time

Timestamp indicating when the topup amount was fully credited to the balance.

rejected_at
string date-time

Timestamp indicating when the topup was rejected.

reversed_at
string date-time

Timestamp indicating when the topup was reversed.

reversed_reason
string

A sentence explaining why the topup was reversed.

idempotency_key
string

Idempotency key to prevent duplicate requests.