The Charge object
The Charge object represents a single attempt to move money into your Zoneless account. PaymentIntent confirmation is the most common way to create Charges. Some legacy payment flows create Charges directly, which is not recommended for new integrations.
Attributes
id string Unique identifier for the object. Zoneless charge IDs are prefixed with ch_z_.
object string String representing the object's type. Objects of the same type share the same value.
amount integer Amount intended to be collected by this payment. A positive integer in the smallest currency unit. For USDC, this is cents (e.g., 100 = $1 USDC). The amount value supports up to eight digits.
amount_captured integer Amount in the smallest currency unit captured (can be less than amount if a partial capture was made).
amount_refunded integer Amount in the smallest currency unit refunded (can be less than amount if a partial refund was issued).
applicationnullable string ID of the Connect application that created the charge.
application_feenullable string The application fee (if any) for the charge.
application_fee_amountnullable integer The amount of the application fee (if any) requested for the charge, in the smallest currency unit.
balance_transactionnullable string ID of the balance transaction that describes the impact of this charge on your account balance (not including refunds or disputes).
billing_details object Billing information associated with the payment method at the time of the transaction.
calculated_statement_descriptornullable string The full statement descriptor after static and dynamic portions are combined. Retained for API compatibility; USDC transfers on Solana do not display bank statement descriptors.
Difference from Stripe: Blockchain payments have no card network statement descriptor. This field is typically null.
captured boolean If the charge was created without capturing, this Boolean represents whether it is still uncaptured or has since been captured.
created timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
currency string Three-letter currency code, in lowercase. For Zoneless, this is typically usdc.
Difference from Stripe: Uses usdc instead of fiat currency codes like usd.
customernullable string ID of the customer this charge is for, if one exists.
descriptionnullable string An arbitrary string attached to the object. Often useful for displaying to users.
disputed boolean Whether the charge has been disputed.
failure_balance_transactionnullable string ID of the balance transaction that describes the reversal of the balance on your account due to payment failure.
failure_codenullable string Error code explaining the reason for charge failure, if available.
failure_messagenullable string Message further explaining the reason for charge failure, if available.
fraud_detailsnullable object Information on fraud assessments for the charge.
livemode boolean Has the value true if the object exists in live mode or the value false if the object exists in test mode.
metadata object Set of key-value pairs that you can attach to an object. Useful for storing additional information in a structured format.
on_behalf_ofnullable string The connected account (if any) the charge was made on behalf of without triggering an automatic transfer.
outcomenullable object Details about whether the payment was accepted, and why.
paid boolean true if the charge succeeded, or was successfully authorized for later capture.
payment_intentnullable string ID of the PaymentIntent associated with this charge, if one exists.
payment_methodnullable string ID of the payment method used in this charge.
payment_method_detailsnullable object Details about the payment method at the time of the transaction.
Difference from Stripe: Zoneless charges typically use type: "crypto" with USDC wallet details. Other payment method hashes may appear for API compatibility but are not used for settlement.
presentment_detailsnullable object Information about the currency presentation to the customer, including the displayed currency and amount used for conversion.
radar_optionsnullable object Options used for fraud/risk assessment, when provided.
receipt_emailnullable string The email address that the receipt for this charge was sent to.
receipt_numbernullable string The transaction number that appears on email receipts sent for this charge. This attribute is null until a receipt has been sent.
receipt_urlnullable string URL to view the receipt for this charge, when available.
refunded boolean Whether the charge has been fully refunded. If the charge is only partially refunded, this attribute remains false.
refundsnullable object A list of refunds that have been applied to the charge.
reviewnullable string ID of the review associated with this charge, if one exists.
shippingnullable object Shipping information for the charge.
source_transfernullable string The transfer ID which created this charge. Only present if the charge came from another Zoneless account.
statement_descriptornullable string Text that appears as the statement descriptor for non-card charges. Retained for API compatibility; Solana USDC transfers do not display bank statement descriptors.
statement_descriptor_suffixnullable string Suffix concatenated with the account statement descriptor prefix. Retained for API compatibility.
status enum The status of the payment.
succeededThe charge succeeded.pendingThe charge is authorized but not yet captured, or still processing.failedThe charge failed.transfernullable string ID of the transfer to the destination account (only applicable if the charge was created using destination / transfer data).
transfer_datanullable object An optional dictionary including the account to automatically transfer to as part of a destination charge.
transfer_groupnullable string A string that identifies this transaction as part of a group.
More attributes
{
"id": "ch_z_3NqR2xLkdIwHu7ix8kP4mQ2a",
"object": "charge",
"amount": 2500,
"amount_captured": 2500,
"amount_refunded": 0,
"application": null,
"application_fee": null,
"application_fee_amount": null,
"balance_transaction": "txn_z_3NqR2xLkdIwHu7ix2bR9nT4c",
"billing_details": {
"address": {
"city": null,
"country": null,
"line1": null,
"line2": null,
"postal_code": null,
"state": null
},
"email": "ava.chen@example.com",
"name": "Ava Chen",
"phone": null,
"tax_id": null
},
"calculated_statement_descriptor": null,
"captured": true,
"created": 1716234567,
"currency": "usdc",
"customer": "cus_z_NffrFeUfNV2Hib",
"description": "Order #4821",
"disputed": false,
"failure_balance_transaction": null,
"failure_code": null,
"failure_message": null,
"fraud_details": {},
"livemode": false,
"metadata": {},
"on_behalf_of": null,
"outcome": {
"advice_code": null,
"network_advice_code": null,
"network_decline_code": null,
"network_status": "approved_by_network",
"reason": null,
"risk_level": "normal",
"risk_score": null,
"rule": null,
"seller_message": "Payment complete.",
"type": "authorized"
},
"paid": true,
"payment_intent": "pi_z_3NqR2xLkdIwHu7ix1aK8vL3d",
"payment_method": "pm_z_1NqR2xLkdIwHu7ixWallet9",
"payment_method_details": {
"type": "crypto",
"crypto": {
"buyer_address": "8xK2Nv3FpQ7mR9sT1uVwXyZ4aBcDeFgH",
"fingerprint": null,
"network": "solana",
"token_currency": "usdc",
"transaction_hash": "5xK9mNpQ2rStUvWxYzAbCdEfGhIjKlMnOpQr"
}
},
"presentment_details": null,
"radar_options": null,
"receipt_email": "ava.chen@example.com",
"receipt_number": null,
"receipt_url": null,
"refunded": false,
"refunds": {
"object": "list",
"data": [],
"has_more": false,
"url": "/v1/charges/ch_z_3NqR2xLkdIwHu7ix8kP4mQ2a/refunds"
},
"review": null,
"shipping": null,
"source_transfer": null,
"statement_descriptor": null,
"statement_descriptor_suffix": null,
"status": "succeeded",
"transfer": null,
"transfer_data": null,
"transfer_group": null,
"platform_account": "acct_z_Platform123abc"
}