> For the complete documentation index, see [llms.txt](https://apidocs.arionbanki.is/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.arionbanki.is/b2b-2013-schema/b2b-services/b2b-foreign-payments/use-cases.md).

# Use Cases

### Enter creditor number <a href="#toc413068273" id="toc413068273"></a>

<div data-full-width="true"><figure><img src="https://2818695535-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6XBw80lUfS2N0XzK27%2Fuploads%2FuULEo7luUWv9T8iq5A88%2F2.1.png?alt=media&amp;token=5fa62599-de96-4d68-b448-c2c6e3de5d99" alt=""><figcaption></figcaption></figure></div>

### Enter payment(s) in new batch of payments <a href="#toc413068274" id="toc413068274"></a>

<div data-full-width="true"><figure><img src="https://2818695535-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6XBw80lUfS2N0XzK27%2Fuploads%2FlgzavPW5JA8O4rOBFv5x%2F2.2.png?alt=media&amp;token=6a89ea54-9e0e-444f-a39c-33e4a52634dd" alt=""><figcaption></figcaption></figure></div>

EnterForeignPayment records single foreign payments in a payment batch in the Online Bank under Foreign Transactions – List of Payments. EnterForeignPayments records many foreign payments in a payment batch. The input data for both queries is the same. The functions both produce a unique number for the batch in which payments were recorded.

If errors occur in the input data for individual payment, a batch will not be created. Errors appear in the error section of the output. The error number is shown in Error.Code and the description of the error in Error.Message. The error needs to be corrected and the payment query re-sent in order to complete the entry.

If an error occurs in the input data when entering many payments all errors which occur are displayed, i.e. collection of Error. The error number is displayed in Error.Code and a description of the error is displayed in Error.Message for the transaction which the error applies to. Note that the line number of the payment (Error.LineNumber) appears to the user which indicates the order of the entry in the input. It is a counter which starts at 0 so that the first entry in the input is number 0 and the error connected to it has line number 0. No payments are recorded. The errors need to be corrected and the entire batch re-sent in order to complete the entry.

### Add payment(s) in new batch of payments <a href="#toc413068275" id="toc413068275"></a>

<div data-full-width="true"><figure><img src="https://2818695535-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6XBw80lUfS2N0XzK27%2Fuploads%2F3nAvZTlFfZcFcyu2tg0k%2F2.3.png?alt=media&amp;token=db4e6818-ef41-491d-b758-7319b3a57b46" alt=""><figcaption></figcaption></figure></div>

### Get receipts for foreign payments <a href="#toc413068276" id="toc413068276"></a>

<div data-full-width="true"><figure><img src="https://2818695535-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6XBw80lUfS2N0XzK27%2Fuploads%2FixHkwsS4X4BDz6YSAXxe%2F2.4.png?alt=media&amp;token=c4ae326d-63e8-4db9-9291-17151e8031bd" alt=""><figcaption></figcaption></figure></div>