GALANTHUS / ABI FUNCTION REFERENCE
gln_get_transaction_remote_iban
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_transaction_remote_iban(const gln_transaction_t* in_transaction);
Purpose
Returns the remote party IBAN.
Return
Returns the counterparty IBAN stored on the row. For debit rows this is typically the creditor/recipient IBAN; for credit rows it is typically the debtor/sender IBAN when the parser can derive direction.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_transaction | input | const gln_transaction_t* | nullable | borrowed |
Counterparty Semantics
Returns the counterparty IBAN stored on the row. For debit rows this is typically the creditor/recipient IBAN; for credit rows it is typically the debtor/sender IBAN when the parser can derive direction.
An empty string means the source row did not provide a usable counterparty IBAN. The pointer itself is non-null for a valid row.
Notes
Passing NULL for in_transaction 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.