Skip to content

GALANTHUS / ABI FUNCTION REFERENCE

gln_get_batch_transfer_submission_id

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

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

Purpose

Reads the ID field from a typed batch-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 batch-transfer submissions return NULL. EBICS success submissions also return NULL when the response body omitted the order ID.

Return

Returns the EBICS order_id when the successful EBICS batch-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_batch_transfer_submission_t*nullableborrowed

Submission Identity

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

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