GALANTHUS / ABI FUNCTION REFERENCE
gln_get_direct_debit_submission_status
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_direct_debit_submission_status(
const gln_direct_debit_submission_t* in_submission);
Purpose
Reads the status field from a typed direct-debit 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/result status string stored on the successful direct-debit submission view. Treat it as an open string rather than a fixed C enum.
Return
Returns the status string stored on the direct-debit submission view produced by a successful result envelope.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_submission | input | const gln_direct_debit_submission_t* | nullable | borrowed |
Submission Status
Returns the status string stored on the direct-debit submission view produced by a successful result envelope.
The value is provider/result data, not a Galanthus C enum. Compare only status strings your caller explicitly understands and do not infer final bank acceptance from this accessor alone.
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.