GALANTHUS / ABI FUNCTION REFERENCE
gln_get_balance_pending_amount
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_balance_pending_amount(const gln_balance_t* in_balance);
Purpose
Returns the pending amount when available.
Return
Returns the pending balance amount when the provider supplies a separate pending-balance field. Returns NULL when the optional field is not materialized or when the input handle is NULL.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_balance | input | const gln_balance_t* | nullable | borrowed |
Amount Semantics
Returns the pending balance amount when the provider supplies a separate pending-balance field.
FinTS 3.x parsing marks debit pending balances with a leading - when the source supplies debit/credit direction. NULL means no pending amount was materialized for the row.
Notes
Passing NULL for in_balance is allowed and returns NULL.
NULL means the provider did not supply this optional field for the row.
The returned pointer is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.