# Create the Swiss Payments Code from the given parameters (deprecated)

Endpoint: POST /qr-invoice/swiss-payments-code
Version: 2.0
Security: X-API-Key, api_key

## Request fields (application/json):

  - `creditorInformation` (object, required)

  - `creditorInformation.iban` (string, required)
    IBAN or QR-IBAN of the creditor.Fixed length: 21 alphanumeric characters, only IBANs with CH or LI country code permitted.
    Example: "CH3908704016075473007"

  - `creditorInformation.creditor` (object, required)

  - `creditorInformation.creditor.addressType` (string, required)
    Address typeThe address type is specified using a code. The following codes are defined:"S" - structured address"K" - combined address elements (2 lines). DEPRECATED - discontinued and no longer supported after 21.11.2025
    Enum: "STRUCTURED", "COMBINED"

  - `creditorInformation.creditor.name` (string, required)
    The creditor's name or company according to the account name.Comment: always matches the account holderMaximum 70 characters permittedFirst name (optional, if available) + last name or company name
    Example: "Robert Schneider AG"

  - `creditorInformation.creditor.streetName` (string)
    Street/P.O. box of the creditorMaximum 70 characters permitted, may not include any house or building number.
    Example: "Rue du Lac"

  - `creditorInformation.creditor.houseNumber` (string)
    House number of the creditorMaximum 16 characters permitted
    Example: "1268/2/22"

  - `creditorInformation.creditor.postalCode` (string, required)
    Postal code of the creditorMaximum 16 characters permitted. The postal code is always to be entered without a country code prefix.
    Example: "2501"

  - `creditorInformation.creditor.city` (string, required)
    City of the creditorMaximum 35 characters permitted
    Example: "Biel"

  - `creditorInformation.creditor.country` (string, required)
    Country of the creditorTwo-digit country code according to ISO 3166-1
    Example: "CH"

  - `creditorInformation.creditor.addressLine1` (string)
    Address line 1 including street and building number or P.O. BoxMaximum 70 characters permitted
    Example: "Rue du Lac 1268/2/22"

  - `creditorInformation.creditor.addressLine2` (string)
    Address line 2 including postal code and town from creditor’s addressMaximum 70 characters permittedMust be provided for address type "K".
    Example: "2501 Biel"

  - `ultimateCreditor` (object)

  - `ultimateCreditor.name` (string)
    Name or company of the ultimate creditorMaximum 70 characters permitted. first name (optional, if available) and last name or company name.
    Example: "Robert Schneider Services Switzerland AG"

  - `ultimateCreditor.streetName` (string)
    Street/P.O. box of the ultimate creditorMaximum 70 characters permitted; may not include any house or building number.
    Example: "Rue du Lac"

  - `ultimateCreditor.houseNumber` (string)
    House number of the ultimate creditorMaximum 16 characters permitted
    Example: "1268/3/1"

  - `ultimateCreditor.postalCode` (string)
    Postal code of the ultimate creditorMaximum 16 characters permitted; is always to be entered without a country code prefix.
    Example: "2501"

  - `ultimateCreditor.city` (string)
    City of the ultimate creditorMaximum 35 characters permitted
    Example: "Biel"

  - `ultimateCreditor.country` (string)
    Country of the ultimate creditorTwo-digit country code according to ISO 3166-1
    Example: "CH"

  - `ultimateCreditor.addressLine2` (string)
    Address line 2 including postal code and town from ultimate creditor’s addressMaximum 70 characters permittedMust be provided for address type "K".
    Example: "2501 Biel"

  - `paymentAmountInformation` (object, required)

  - `paymentAmountInformation.amount` (number)
    The payment amountThe amount element is to be entered without leading zeroes, including decimal separators and two decimal places.Decimal, maximum 12-digits permitted, including decimal separators. Only decimal points (".") are permitted as decimal separators.
    Example: 199.95

  - `paymentAmountInformation.currency` (string, required)
    The payment currency, 3-digit alphanumeric currency code according to ISO 4217Only CHF and EUR are permitted.
    Enum: "CHF", "EUR"

  - `ultimateDebtor` (object)

  - `ultimateDebtor.name` (string)
    Name or company of the ultimate debtorMaximum 70 characters permitted; first name (optional, if available) and last name or company name.
    Example: "Pia-Maria Rutschmann-Schnyder"

  - `ultimateDebtor.streetName` (string)
    Street/P.O. Box of the ultimate debtorMaximum 70 characters permitted; may not include any house or building number.
    Example: "Grosse Marktgasse"

  - `ultimateDebtor.houseNumber` (string)
    House number of the ultimate debtorMaximum 16 characters permitted
    Example: "28"

  - `ultimateDebtor.postalCode` (string)
    Postal code of the ultimate debtorMaximum 16 characters permitted; is always to be entered without a country code prefix.
    Example: "9400"

  - `ultimateDebtor.city` (string)
    City of the ultimate debtorMaximum 35 characters permitted
    Example: "Rorschach"

  - `ultimateDebtor.country` (string)
    Country of the ultimate debtorTwo-digit country code according to ISO 3166-1
    Example: "CH"

  - `paymentReference` (object, required)

  - `paymentReference.referenceType` (string, required)
    Reference type (QR, ISO)The following codes are permitted:QRR – QR referenceSCOR – Creditor Reference (ISO 11649)NON – without referenceMaximum four characters, alphanumericMust contain the code QRR where a QR-IBAN is used;where the IBAN is used, either the SCOR or NON code can be entered
    Enum: "QRR", "SCOR", "NON"

  - `paymentReference.reference` (string)
    Reference numberStructured payment referenceThe reference is either a QR reference or a Creditor Reference (ISO 11649)Maximum 27 characters, alphanumeric;must be filled if a QR-IBAN is used.QR reference: 27 characters, numeric, check sum calculation according to Modulo 10 recursive (27th position of the reference)Creditor Reference (ISO 11649): max 25 characters, alphanumericThe element may not be filled for the NON reference type.REST APIOn the REST API automatic creation of both QRR and SCOR reference numbers can be used. To do so, wrap the reference number in curly brackets . In case of the QRR, customerId can be passed as well, separated by a colon, e.g. , whereas 123456 is the customerId
    Example: "RF18539007547034"

  - `paymentReference.additionalInformation` (object)

  - `paymentReference.additionalInformation.unstructuredMessage` (string)
    Unstructured messageUnstructured information can be used to indicate the payment purpose or for additional textual information about payments with a structured reference.Maximum 140 characters
    Example: "Bill No. 3139 for garden work and disposal of cuttings"

  - `paymentReference.additionalInformation.billInformation` (string)
    Bill information contain coded information for automated booking of the payment. The data is not forwarded with the payment.
    Example: "//S1/10/10201409/11/190512/20/1400.000-53/30/106017086/31/180508/32/7.7/40/2:10;0:30"

  - `paymentReference.additionalInformation.billInformationObject` (object)
    Interface type, see SwicoS1v12 or RawBillInformation

  - `alternativeSchemes` (object)

  - `alternativeSchemes.alternativeSchemeParameters` (array)
    Example: ["eBill/B/john.doe@example.com"]