GALANTHUS / ABI FUNCTION REFERENCE
gln_get_balance_iban
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_balance_iban(const gln_balance_t* in_balance);
Purpose
Returns the balance account IBAN.
Return
Returns the IBAN for the account whose balance row was materialized. FinTS balance responses that do not repeat the IBAN use the requested account IBAN.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_balance | input | const gln_balance_t* | nullable | borrowed |
Balance Identity
Returns the IBAN for the account whose balance row was materialized. FinTS balance responses that do not repeat the IBAN use the requested account IBAN.
An empty string means neither the response nor the request context provided an IBAN. The pointer itself is non-null for a valid row.
Notes
Passing NULL for in_balance is allowed and returns NULL.
Rows returned by the matching _at accessor carry this field as part of the materialized typed result.
The returned pointer is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.