### HBCI4Java Status Callback Example

Source: https://github.com/hbci4j/hbci4java/blob/master/src/main/java/org/kapott/hbci/callback/package.html

Illustrates how to handle status updates within an HBCI dialog using a switch statement to evaluate status tags. This is a standard approach for tracking the progress of an HBCI dialog.

```java
public void status(HBCIPassport passport,int statusTag,Object[] o)
{
    switch (statusTag) {
        case STATUS_DIALOG_INIT:
            printStatusInfo("fuehre dialog-initialisierung aus");
            break;
        case STATUS_DIALOG_INIT_DONE:
            printStatusInfo("dialog-init durchgeführt, dialogid ist "+o[0].toString());
            break;
        // usw. usf.
    }
}
```

--------------------------------

### Liste noch anstehender terminierten Überweisungen abholen (Fetch List of Pending Scheduled Transfers)

Source: https://github.com/hbci4j/hbci4java/blob/master/src/main/java/org/kapott/hbci/GV/package.html

Retrieves a list of all pending scheduled transfers. The high-level name is 'TermUebList'.

```APIDOC
## TermUebList (Fetch List of Pending Scheduled Transfers)

### Description
Fetches a list of all scheduled transfers that are still pending execution.

### HighLevel-Name
`TermUebList`

### Parameters
- **my** (Konto) - Optional - The customer's account for which to retrieve the list. If not specified, the first account from the UPD is used.
- **startdate** (Date) - Optional - Only retrieve orders scheduled on or after this date.
- **enddate** (Date) - Optional - Only retrieve orders scheduled on or before this date.

### Return Value Class
[`GVRTermUebList`](../GV_Result/GVRTermUebList.html)
```

--------------------------------

### HBCI Dialog Execution and Status Check

Source: https://github.com/hbci4j/hbci4java/blob/master/src/main/java/org/kapott/hbci/status/package.html

This snippet demonstrates how to add a business task, execute an HBCI dialog, and check the overall dialog status and individual job results. It shows how to retrieve error strings if the dialog or a specific job fails.

```Java
// initialize HBCI-stuff here
...

// add a business task
HBCIJob jobSaldo=hbciHandle.newJob("SaldoReq");
jobSaldo.setParam("my",myAccount);
hbciHandle.addJob(jobSaldo);

// add more business tasks here
...

// execute dialog
HBCIDialogStatus dialogStatus=hbciHandler.execute();

// print information about complete dialog
if (!dialogStatus.isOK()) {
    System.out.println("some error has occured during execution of the HBCI dialog:");
    System.out.println(dialogStatus.getErrorString());
}

// check each business task
if (jobSaldo.getJobResult().isOK()) {
    System.out.println("saldo information for account "+myAccount);
    System.out.println(jobSaldo.getJobResult().toString());
} else {
    System.out.println("an error occured in task SaldoRequest");
    System.out.println(jobSaldo.getJobResult().jobStatus.getErrorString());
}
 
...
```

--------------------------------

### Generic Callback Handler in Java

Source: https://github.com/hbci4j/hbci4java/blob/master/src/main/java/org/kapott/hbci/callback/package.html

This Java code snippet demonstrates a generic `callback()` method that handles various callback scenarios based on the `datatype` and `retData` parameters. It includes logic for text, secret, and boolean inputs, as well as informational messages and actions.

```Java
public void callback(HBCIPassport passport,int reason,String msg,int datatype,StringBuffer retData)
{
    try {
        output(msg);
        if (datatype!=TYPE_NONE) {
            switch (datatype) {
                case TYPE_TEXT:
                case TYPE_SECRET: // dafuer muss nur die Eingabe durch Sternchen ("*") versteckt werden
                    // Eingabe in Rückgabeobjekt schreiben
                    output("current value: "+retData.toString());
                    retData.replace(0,retData.length(),readUserInput());
                    break;
                
                case TYPE_BOOLEAN:
                    String input=readUserInput();
                    // Eingabe von "yes" für den einen Fall (TRUE),
                    // jeder andere Text führt zu dem anderen Fall (FALSE)
                    // siehe dazu Beschreibung von TYPE_BOOLEAN
                    if (input.equals("yes"))
                        retData.replace(0,retData.length(),"");
                    else
                        retData.replace(0,retData.length(),"error");
                    break;
            }
        } else {
            if (retData!=null) {
                // auf bestätigung warten
                waitForConfirmation();
            }
        }
    } catch (Exception e) {
        throw new HBCI_Exception("error while handling callback",e);
    }
}
```

--------------------------------

### Auslandsüberweisung (International Transfer)

Source: https://github.com/hbci4j/hbci4java/blob/master/src/main/java/org/kapott/hbci/GV/package.html

Allows initiating a simple international transfer to most European countries for amounts not exceeding the legal reporting threshold (currently 12500 EUR). The high-level name is 'UebForeign'.

```APIDOC
## UebForeign (International Transfer)

### Description
Enables the initiation of a simple international bank transfer, suitable for most European countries, provided the amount does not exceed the legal reporting threshold (currently 12500 EUR).

### HighLevel-Name
`UebForeign`

### Parameters
- **src** (Konto) - Mandatory - The customer's debit account.
  - **src.name** (String) - Mandatory - Name of the account holder.
- **dst** (Konto) - Optional - The account where the amount should be credited. Either this parameter or `dst.iban` must be provided.
  - **dst.iban** (String) - Optional - The IBAN of the destination account. Must be provided if `dst` is not specified.
  - **dst.name** (String) - Mandatory - Name of the beneficiary.
  - **dst.kiname** (String) - Mandatory - Full name of the destination bank.
- **btg** (Value) - Mandatory - The amount to be transferred.
- **usage** (String) - Optional - Purpose of the transfer.

### Return Value Class
[`HBCIJobResult`](../GV_Result/HBCIJobResult.html)
```

--------------------------------

### Generic Status Callback Handler in Java

Source: https://github.com/hbci4j/hbci4java/blob/master/src/main/java/org/kapott/hbci/callback/package.html

A pragmatic solution for a generic status callback handler that dynamically identifies status constants by name. This approach avoids explicitly listing all possible STATUS_* constants.

```java
public void status(HBCIPassport passport,int statusTag,Object[] o) 
{
    try {
        Class cl=this.getClass();
        Field[] fields=cl.getFields();

        for (int i=0;i<fields.length;i++) {
            Field field=fields[i];
            String name=field.getName();

            if (name.startsWith("STATUS_")) {
                int value=field.getInt(this);
                if (value==statusTag) {
                    printStatusInfo("status: "+name);
                    if (o!=null) {
                        for (int j=0;j<o.length;j++) {
                            if (o[j] instanceof String)
                                printStatusInfo("statusdata: "+o[j]);
                            else
                                printStatusInfo("class of status data: "+o[j].getClass().getName());
                        }
                    }
                    break;
                }
            }
        }
    } catch (Exception e) {
        throw new HBCI_Exception("error while getting name of constant for statusTag "+statusTag,e); 
    }
}
```

--------------------------------

### Terminierte Einzelüberweisung (Scheduled Single Transfer)

Source: https://github.com/hbci4j/hbci4java/blob/master/src/main/java/org/kapott/hbci/GV/package.html

A single transfer with a specified execution date. The high-level name is 'TermUeb'.

```APIDOC
## TermUeb (Scheduled Single Transfer)

### Description
Schedules a single bank transfer for a future date. The specified date must be a business day and typically requires a minimum notice period.

### HighLevel-Name
`TermUeb`

### Parameters
Parameters are the same as for a standard single transfer (`Einzelüberweisung`), with the addition of:

- **date** (Date) - Mandatory - The planned execution date for the transfer.

### Return Value Class
[`GVRTermUeb`](../GV_Result/GVRTermUeb.html)
```

--------------------------------

### Eilüberweisung (Urgent Transfer)

Source: https://github.com/hbci4j/hbci4java/blob/master/src/main/java/org/kapott/hbci/GV/package.html

Initiates an urgent bank transfer, which may be processed faster than a standard transfer. The high-level name is 'UebEil'.

```APIDOC
## UebEil (Urgent Transfer)

### Description
Performs an urgent bank transfer. The exact processing speed depends on bank-specific factors.

### HighLevel-Name
`UebEil`

### Parameters
Parameters are the same as for a standard single transfer (`Einzelüberweisung`).

### Return Value Class
[`HBCIJobResult`](../GV_Result/HBCIJobResult.html)
```

--------------------------------

### SEPA-Einzelüberweisung (SEPA Single Transfer)

Source: https://github.com/hbci4j/hbci4java/blob/master/src/main/java/org/kapott/hbci/GV/package.html

A SEPA-standard transfer for in- and out-of-country accounts using IBAN and BIC. The high-level name is 'UebSEPA'.

```APIDOC
## UebSEPA (SEPA Single Transfer)

### Description
Executes a single transfer according to the SEPA standard, applicable for both domestic and international accounts within the SEPA zone. This method uses IBAN for account identification and BIC for bank identification.

### HighLevel-Name
`UebSEPA`

### Parameters
- **src** (Konto) - Mandatory - The customer's debit account. Requires `bic`, `iban`, and `name` to be set.
- **dst** (Konto) - Mandatory - The account where the amount should be credited. Requires `bic`, `iban`, and `name` to be set.
- **btg** (Value) - Mandatory - The amount to be transferred. The currency must always be `EUR`.
- **usage** (String) - Optional - Purpose of the transfer (max. 140 characters).

### Return Value Class
[`HBCIJobResult`](../GV_Result/HBCIJobResult.html)
```

--------------------------------

### Spendenüberweisung (Donation Transfer)

Source: https://github.com/hbci4j/hbci4java/blob/master/src/main/java/org/kapott/hbci/GV/package.html

A special type of single transfer used for donations, with a bank-internally set text key. The high-level name is 'Donation'.

```APIDOC
## Donation (Donation Transfer)

### Description
Facilitates a donation transfer, which is essentially a standard single transfer but uses a specific bank-defined text key for the transaction type.

### HighLevel-Name
`Donation`

### Parameters
Similar to [`Einzelüberweisung`](#ueb), but without the usage lines. Instead, the following parameters are used:

- **spenderid** (String) - Mandatory - Name of the donor or customer/member number.
- **plz_street** (String) - Mandatory - Postal code and street of the donor.
- **name_ort** (String) - Mandatory - Name and city of the payer.
- **key** (String) - Optional - Text key for transaction type (default: "`69`").

### Return Value Class
[`HBCIJobResult`](../GV_Result/HBCIJobResult.html)
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.