Skip to content

GALANTHUS / ABI FUNCTION REFERENCE

gln_get_transfer_submission_id

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

GLN_API const char* GLN_CALL gln_get_transfer_submission_id(const gln_transfer_submission_t* in_submission);
  • Family: Row field accessors
  • Return type: const char*

Purpose

Reads the ID field from a typed transfer 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 transfer submissions return NULL because the FinTS result type carries no submission ID.

Return

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

TypeNullabilityOwnership
const char*nullableborrowed

Parameters

NameDirectionTypeNullabilityOwnership
in_submissioninputconst gln_transfer_submission_t*nullableborrowed

Submission Identity

Returns the EBICS order_id when the successful EBICS transfer submission result carries one.

FinTS transfer result types carry no submission ID, so FinTS transfer and instant-transfer submission views return NULL. EBICS transfer 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