Skip to main content

InitiatePaymentRequestBody

Generic Body for a payment initiation via JSON.

    endToEndIdentification stringnullable

    Possible values: <= 35 characters

    End to End Identification.

    debtorAccount

    object

    required

    Reference to an account by either

    • IBAN, of a payment accounts, or

    • BBAN, for payment accounts if there is no IBAN, or

    • Not used by SDC the Primary Account Number(PAN) of a card, can be tokenised by the ASPSP due to PCI DSS requirements, or

    • Not used by SDC the Primary Account Number(PAN) of a card in a masked form, or

    • Not used by SDC an alias to access a payment account via a registered mobile phone number(MSISDN).

    • A payment account AccountReferenceOther when using a national payment Form.

    iban stringnullable

    Possible values: Value must match regular expression [A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}

    IBAN of the account.

    bban stringnullable

    Basic Bank Account Number (BBAN) Identifier.

    This data element can be used in the body of the consent request. Message for retrieving account access consent from this account. This data elements is used for payment accounts which have no IBAN. ISO20022: Basic Bank Account Number (BBAN).

    Identifier used nationally by financial institutions, i.e., in individual countries, generally as part of a National Account Numbering Scheme(s), which uniquely identifies the account of a customer

    pan stringnullable

    Possible values: <= 35 characters

    Primary Account Number according to ISO/IEC 7812.

    maskedPan stringnullable

    Possible values: <= 35 characters

    Masked Primary Account Number.

    msisdn stringnullable

    Possible values: <= 35 characters

    Mobile phone number.

    other

    object

    In cases where the specifically defined criteria (IBAN, BBAN, MSISDN) are not provided to identify an instance of the respective account type

    (e.g. a savings account), the ASPSP shall include a proprietary ID of the respective account that uniquely identifies the account for this ASPSP.

    identification stringrequired

    Possible values: non-empty and <= 35 characters

    Proprietary identification of the account.

    schemeNameCode stringnullable

    Possible values: <= 35 characters

    An entry provided by an external ISO code list.

    schemeNameProprietary stringnullable

    Possible values: <= 35 characters

    A scheme name defined in a proprietary way.

    issuer stringnullable

    Possible values: <= 35 characters

    Issuer of the identification.

    currency stringnullable

    Possible values: Value must match regular expression [A-Z]{3}

    Account Currency Code.

    cashAccountType stringnullable

    Possible values: Value must match regular expression [A-Z]{3}

    ExternalCashAccountType1Code from ISO 20022.

    instructedAmount

    object

    required

    Base Model for amount.

    currency stringrequired

    Possible values: non-empty, Value must match regular expression [A-Z]{3}

    Currency Code.

    amount stringrequired

    Possible values: non-empty, Value must match regular expression -?[0-9]{1,14}(\.[0-9]{1,3})?

    The amount given with fractional digits, where fractions must be compliant to the currency definition. Up to 14 significant figures. Negative amounts are signed by minus. The decimal separator is a dot.

    Example Valid representations for EUR with up to two decimals are:

    • 1056
    • 5768.2
    • -1.50
    • 5877.78

    creditorAccount

    object

    required

    Reference to an account by either

    • IBAN, of a payment accounts, or

    • BBAN, for payment accounts if there is no IBAN, or

    • Not used by SDC the Primary Account Number(PAN) of a card, can be tokenised by the ASPSP due to PCI DSS requirements, or

    • Not used by SDC the Primary Account Number(PAN) of a card in a masked form, or

    • Not used by SDC an alias to access a payment account via a registered mobile phone number(MSISDN).

    • A payment account AccountReferenceOther when using a national payment Form.

    iban stringnullable

    Possible values: Value must match regular expression [A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}

    IBAN of the account.

    bban stringnullable

    Basic Bank Account Number (BBAN) Identifier.

    This data element can be used in the body of the consent request. Message for retrieving account access consent from this account. This data elements is used for payment accounts which have no IBAN. ISO20022: Basic Bank Account Number (BBAN).

    Identifier used nationally by financial institutions, i.e., in individual countries, generally as part of a National Account Numbering Scheme(s), which uniquely identifies the account of a customer

    pan stringnullable

    Possible values: <= 35 characters

    Primary Account Number according to ISO/IEC 7812.

    maskedPan stringnullable

    Possible values: <= 35 characters

    Masked Primary Account Number.

    msisdn stringnullable

    Possible values: <= 35 characters

    Mobile phone number.

    other

    object

    In cases where the specifically defined criteria (IBAN, BBAN, MSISDN) are not provided to identify an instance of the respective account type

    (e.g. a savings account), the ASPSP shall include a proprietary ID of the respective account that uniquely identifies the account for this ASPSP.

    identification stringrequired

    Possible values: non-empty and <= 35 characters

    Proprietary identification of the account.

    schemeNameCode stringnullable

    Possible values: <= 35 characters

    An entry provided by an external ISO code list.

    schemeNameProprietary stringnullable

    Possible values: <= 35 characters

    A scheme name defined in a proprietary way.

    issuer stringnullable

    Possible values: <= 35 characters

    Issuer of the identification.

    currency stringnullable

    Possible values: Value must match regular expression [A-Z]{3}

    Account Currency Code.

    cashAccountType stringnullable

    Possible values: Value must match regular expression [A-Z]{3}

    ExternalCashAccountType1Code from ISO 20022.

    creditorAgent stringnullable

    Possible values: Value must match regular expression [A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}

    Creditor Agent.

    creditorAgentName stringnullable

    Possible values: <= 140 characters

    Creditor Agent Name

    creditorName stringrequired

    Possible values: non-empty and <= 70 characters

    Creditor Name

    creditorAddress

    object

    Address

    streetName stringnullable

    Possible values: <= 70 characters

    Street name.

    buildingNumber stringnullable

    Building Number.

    townName stringnullable

    Town Name.

    postalCode stringnullable

    postal Code

    country stringrequired

    Possible values: non-empty, Value must match regular expression [A-Z]{2}

    Country code.

    ISO 3166 ALPHA2 country code. Is only required for Cross border payment

    creditorAgentProprietary stringnullable

    Creditor Name

    chargeBearer ChargeBearer (string)

    Possible values: [debt, cred, shar, slev]

    Charge Bearer. ChargeBearerType1Code from ISO20022 only mandatory for Crossborder

    remittanceInformationUnstructured stringnullable

    Possible values: <= 140 characters

    Unstructured remittance information.

    remittanceInformationUnstructuredArray string[]nullable

    Unstructured remittance information.

    remittanceInformationStructuredArray

    object[]

    nullable

    Array of structured remittance information.

  • Array [

  • reference stringrequired

    Possible values: non-empty and <= 35 characters

    referenceType stringnullable

    Possible values: <= 35 characters

    referenceIssuer stringnullable

    Possible values: <= 35 characters

  • ]