FinTS prepaid top-up: gln prepaid-topup
Synopsis
gln [global-options] prepaid-topup --file <path>
Options
| Argument or flag | Type | Required | Default | Description |
|---|---|---|---|---|
--file | path | yes | - | JSON file describing the prepaid mobile top-up to run. |
Request file fields
| Field | Type | Required | Description |
|---|---|---|---|
source_iban | string | yes | IBAN of the account the top-up is debited from. |
source_bic | string | yes | BIC of the source account institution. |
provider_code | string | yes | FinTS prepaid provider code (operator-specific). |
mobile_number | string | yes | Mobile number to top up. |
amount | string | yes | Decimal amount (e.g. "15", "15.00"). |
All fields must be JSON strings.
Description
Submits a prepaid mobile top-up via the FinTS backend resolved from the active profile. Wires gln_submit_prepaid_topup to the backend.
The backend may signal that a TAN is required before the top-up is accepted; in that case the response carries an action_required envelope with a saved continuation.
Status and exit codes
| Status | Exit | Meaning | Continuation |
|---|---|---|---|
ok | 0 | Top-up accepted by the bank. | - |
action_required | 10 | Bank requires a TAN. The response envelope includes a resume_file path. | Saved at resume_file. |
error | 1 | Validation, transport, or backend error. | - |