GALANTHUS / ABI FUNCTION REFERENCE
gln_get_prepaid_topup_submission_status
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_prepaid_topup_submission_status(
const gln_prepaid_topup_submission_t* in_submission);
Purpose
Reads the status field from a typed prepaid top-up submission without taking ownership of the handle.
The ABI reports a nullable return, so callers should handle NULL defensively. When passed a valid non-null handle, required fields are expected to carry a value.
This is the provider-normalized submission status from the successful FinTS top-up result. Bank acceptance is represented by the provider-normalized status in the success envelope.
Return
Returns the status from the prepaid top-up submission, or NULL when it is not available.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_submission | input | const gln_prepaid_topup_submission_t* | nullable | borrowed |
Notes
Passing NULL for in_submission is allowed and returns NULL.
The returned pointer is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.