gln_get_direct_debit_submission_id

Declared in <galanthus/c_api/gln_capi.h>.

GLN_API const char* GLN_CALL gln_get_direct_debit_submission_id(
    const gln_direct_debit_submission_t* in_submission);

• Family: Row field accessors
• Return type: const char*

Purpose

Reads the ID field from a typed direct-debit submission without taking ownership of the handle.

The return is nullable; callers must handle NULL when the backend did not provide this optional field.

For EBICS success submissions this returns the EBICS order ID when the response body supplied one. FinTS direct-debit submissions return NULL because the FinTS result type carries no submission ID.

Return

Returns the EBICS order_id when the successful EBICS direct-debit submission result carries one. Returns NULL when the optional field is not materialized or when the input handle is NULL.

Parameters

Submission Identity

Returns the EBICS order_id when the successful EBICS direct-debit submission result carries one.

FinTS direct-debit result types carry no submission ID, so FinTS direct-debit submission views return NULL. EBICS direct-debit submissions also return NULL when the response body omitted the order ID.

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.

See Also

• gln_get_backend_result_direct_debit_submission
• gln_get_direct_debit_submission_status
• gln_get_direct_debit_submission_provider_status_count
• ABI function index