GALANTHUS / ABI FUNCTION REFERENCE
gln_get_ebics_service_map_preset_json
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API gln_status_t GLN_CALL gln_get_ebics_service_map_preset_json(
const char* in_preset_name,
char** out_service_map_json,
gln_error_t* out_error);
Purpose
Returns the JSON service-map definition for a named EBICS preset.
Use this helper when constructing setup/profile flows that need a stable EBICS service-map preset without embedding preset JSON in the caller.
Return
Returns GLN_OK on success and a non-OK gln_status_t value on failure.
| Type | Nullability | Ownership |
|---|---|---|
gln_status_t | value | value |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_preset_name | input | const char* | nonnull | borrowed |
out_service_map_json | output | char** | nonnull | transferred_out |
out_error | output | gln_error_t* | nullable | caller_allocated_output |
Presets
dkb returns the built-in DKB service map with statement, balance, credit-transfer, and direct-debit descriptors.
Unsupported preset names return GLN_ERR_NOT_SUPPORTED, populate out_error when provided, and leave *out_service_map_json as NULL.
Ownership
On success, out_service_map_json receives a caller-owned NUL-terminated JSON string. Release it with gln_release_string.
The returned JSON is suitable for profile/setup code that stores or passes a service-map payload to an EBICS configuration layer.