gln_revolut_delete_transfer_idempotency_state

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

GLN_API gln_status_t GLN_CALL gln_revolut_delete_transfer_idempotency_state(
    gln_backend_t* in_backend,
    int*           out_deleted_state_or_null,
    gln_error_t*   out_error);

Family: Revolut provider state cleanup
Return type: gln_status_t

Purpose

Deletes persisted Revolut transfer idempotency state for an opened Revolut backend.

The call removes the provider-owned profile blob used to remember recent Revolut transfer idempotency keys without destroying token state or the backend handle.

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_backend`	input	`gln_backend_t*`	nonnull	borrowed
`out_deleted_state_or_null`	output	`int*`	nullable	caller_allocated_output
`out_error`	output	`gln_error_t*`	nullable	caller_allocated_output

Behavior

in_backend must be a Revolut backend opened with gln_open_revolut_backend.

out_deleted_state_or_null is optional. When supplied, it receives nonzero if the transfer idempotency state blob was removed and zero when no such blob was present.

Deleting transfer idempotency state does not remove OAuth token state, the token-store directory, state store, backend profile, or backend handle.

Scope

The function deletes only Revolut transfer idempotency state owned by the backend profile.

Use gln_revolut_delete_token separately when OAuth token state must be removed.

Example

int deleted_state = 0;
gln_error_t error = {0};
gln_default_error(&error);
gln_status_t rc = gln_revolut_delete_transfer_idempotency_state(backend, &deleted_state, &error);
if (rc == GLN_OK && deleted_state != 0) {
    note_transfer_idempotency_state_removed();
}

gln_release_error(&error);