Skip to content

CdtrAcct

Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.

  • Is optional
  • Type: object

With the following properties:

PropertyTypeRequiredDescription
CcyStringOptionalCurrency for the Creditor Account. Defined in #/definitions/currency
IdObjectRequiredNature or use of the Creditor account.
NmStringOptionalName by which the account is known and which is usually used to identify the Creditor account. Defined in #/definitions/account_name
TpObjectOptionalNature or use of the Creditor account. Defined in #/definitions/account_type

Id

Nature or use of the creditor account.

The full list of Id properties is defined in #/definitions/account_id. However, the following properties are required for CdtrAcct.Id:

PropertyTypeRequiredDescription
IBANStringRequiredHolds the creditor account number in IBAN format.

Usage Guidelines:
  • If you specify IBAN, do not specify Othr.Id
  • Use this property in conjunction with CdtrAgt.FinInstnId.BICFI.
  • An example IBAN string is "DE89370400440532013000".
Othr.IdStringRequiredHolds the creditor account number in non-IBAN format.

Usage Guidelines:
  • If you specify Othr.Id, do not specify IBAN.
  • Provide information to support the following types of transfers or payouts:
    • Bank account transfers: Specify non-IBAN bank account number.
    • Card transfers: Specify the card number.
    • Mobile wallet or e-wallet transfers: Specify the mobile or e-wallet number.
    • Cash transfers or other transfers that do not require a payout instrument ID: Specify NOTREQUIRED.
    • Bill payments: Specify the bill reference number, or the account number, or the customer reference number.
  • Use this property in conjunction with CdtrAgt.ClrSysMmbId.MmbId.
  • An example non-IBAN string is "5320130".
Othr.SchmeNm.CdStringRequired only if Othr.Id is specified. Not applicable otherwise.Type of account number, list based on a combination of ExternalAccountIdentification1Code and AccountIdentification30Choice ISO 20022 Lists 27-Aug-2021.

Usage Guidelines:
  • Do not specify Othr.SchmeNm.Cd if you do not specify Othr.Id.
  • The value of this property must be equal to one of the known values. The list of known values is defined in #/definitions/external_account_id.
  • An example value for a bank account transfer is BBAN.
    An example value for a cash payout is CASH.

JSON schema extract

"CdtrAcct": {
    "type": "object",
    "description": "Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.",
    "properties": {
        "Nm": {
            "type": "string",
            "description": "Name by which the account is known and which is usually used to identify the Creditor account.",
            "$ref": "#/definitions/account_name"
        },
        "Ccy": {
            "type": "string",
            "description": "Currency for the Creditor Account",
            "$ref": "#/definitions/currency"
        },
        "Id": {
            "type": "object",
            "description": "Identifier for the Creditor account.",
            "$ref": "#/definitions/account_id"
        },
        "Tp": {
            "type": "object",
            "description": "Nature or use of the Creditor account.",
            "$ref": "#/definitions/account_type"
        }
    }
}