GALANTHUS / ABI FUNCTION REFERENCE
gln_get_transaction_end_to_end_reference
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_transaction_end_to_end_reference(
const gln_transaction_t* in_transaction);
Purpose
Returns the end-to-end reference when available.
Return
Returns the payment end-to-end reference when the source row supplies one, such as CAMT EndToEndId, MT940 structured subfield data, or plugin-mapped payment reference data. 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_transaction | input | const gln_transaction_t* | nullable | borrowed |
Payment Metadata
Returns the payment end-to-end reference when the source row supplies one, such as CAMT EndToEndId, MT940 structured subfield data, or plugin-mapped payment reference data.
NULL means the materialized transaction row has no end-to-end reference.
Notes
Passing NULL for in_transaction 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.