# Transaction received

Fired when a new transaction has been received for an account. The payload contains the full transaction information including amounts, parties, and remittance data.

Related endpoint: Get transaction details

Endpoint: POST banking.account.transaction.received
Version: 1.0.0

## Request fields (application/json):

  - `transactionId` (string, required)
    Unique identifier of the transaction.

  - `accountId` (string, required)
    Identifier of the account the transaction belongs to.

  - `references` (object)
    References associated with a transaction.

  - `references.endToEndIds` (array)
    End-to-end identifiers.

  - `references.instructionId` (string,null)
    Instruction identifier from pain.001.

  - `references.accountServicerReference` (string,null)
    Account servicer reference (archive reference).

  - `references.mandateId` (string,null)
    Direct debit mandate identifier.

  - `references.checkNumber` (string,null)
    Cheque identifier.

  - `entryReference` (string,null)
    Entry reference of the transaction.

  - `valueDate` (string,null)
    The date the amount becomes available.

  - `bookingDate` (string,null)
    The date the transaction was booked.

  - `transactionAmount` (object, required)
    An amount with currency.

  - `transactionAmount.currency` (string)
    ISO 4217 Alpha 3 currency code.

  - `transactionAmount.amount` (string)
    The amount as a decimal string.

  - `amountDetails` (object)
    Detailed amount information with exchange rate details.

  - `amountDetails.instructedAmount` (object)
    Amount with optional exchange rate information.

  - `amountDetails.instructedAmount.currency` (string,null)
    ISO 4217 currency code.

  - `amountDetails.instructedAmount.amount` (string,null)
    Decimal amount.

  - `amountDetails.instructedAmount.sourceCurrency` (string,null)
    Source currency of the exchange.

  - `amountDetails.instructedAmount.exchangeRate` (number,null)
    Exchange rate applied.

  - `amountDetails.instructedAmount.unitCurrency` (string,null)
    Unit currency.

  - `amountDetails.instructedAmount.targetCurrency` (string,null)
    Target currency.

  - `amountDetails.instructedAmount.quotationDate` (string,null)
    Date of the exchange rate quotation.

  - `amountDetails.instructedAmount.contractId` (string,null)
    FX contract identifier.

  - `amountDetails.transactionAmount` (object)
    Amount with optional exchange rate information.

  - `charge` (object)
    Transaction charge information.

  - `charge.amount` (object)
    An amount with currency.

  - `charge.chargeBearer` (string)
    Specifies which party bears the charges.
    Enum: "debt", "cred", "shar", "slev"

  - `currencyExchange` (array)
    Currency exchange information.

  - `currencyExchange.sourceCurrency` (string, required)
    Source currency code.

  - `creditor` (object)
    A party (creditor or debtor) in a transaction.

  - `creditor.name` (string,null)
    Name of the party.

  - `creditor.postalAddress` (object)
    Postal address of a party.

  - `creditor.postalAddress.addressLines` (array)
    Address lines.

  - `creditor.postalAddress.streetName` (string,null)
    Street name.

  - `creditor.postalAddress.buildingNumber` (string,null)
    Building number.

  - `creditor.postalAddress.postCode` (string,null)
    Postal code.

  - `creditor.postalAddress.townName` (string,null)
    Town name.

  - `creditor.postalAddress.country` (string,null)
    ISO 3166-1 alpha-2 country code.

  - `creditorAccount` (object)
    Reference to an account using various identification schemes.

  - `creditorAccount.iban` (string,null)
    International Bank Account Number.

  - `creditorAccount.bban` (string,null)
    Basic Bank Account Number.

  - `creditorAccount.other` (object)
    Generic account identification.

  - `creditorAccount.other.identification` (string, required)
    Account identification value.

  - `creditorAccount.other.schemeName` (string, required)
    Name of the identification scheme (e.g., BBAN, BGNR, PGNR).

  - `creditorAccount.pan` (string,null)
    Primary Account Number.

  - `creditorAccount.maskedPan` (string,null)
    Masked Primary Account Number.

  - `creditorAccount.msisdn` (string,null)
    Mobile phone number (MSISDN).

  - `debtor` (object)
    A party (creditor or debtor) in a transaction.

  - `debtorAccount` (object)
    Reference to an account using various identification schemes.

  - `remittanceInformationUnstructured` (array)
    Unstructured remittance information.

  - `remittanceInformationStructured` (array)
    Structured remittance information.

  - `remittanceInformationStructured.remittanceAmount` (object)
    An amount with currency.

  - `remittanceInformationStructured.referredDocumentInformation` (array)
    Information about referred documents.

  - `remittanceInformationStructured.referredDocumentInformation.typeCode` (string)
    ISO 20022 document type code.
    Enum: "msin", "cnfa", "dnfa", "cinv", "cren", "debn", "hiri", "sbin", "cmcn", "soac", "disp", "bold", "vchr", "aroi", "tsut", "puor"

  - `remittanceInformationStructured.referredDocumentInformation.typeProprietary` (string,null)
    Proprietary document type.

  - `remittanceInformationStructured.referredDocumentInformation.typeIssuer` (string,null)
    Issuer of the document type.

  - `remittanceInformationStructured.referredDocumentInformation.number` (string,null)
    Document number.

  - `remittanceInformationStructured.referredDocumentInformation.relatedDate` (string,null)
    Related date.

  - `remittanceInformationStructured.creditorReferenceInformation` (object)
    Reference information from the creditor.

  - `remittanceInformationStructured.creditorReferenceInformation.reference` (string, required)
    The creditor reference value.

  - `remittanceInformationStructured.creditorReferenceInformation.referenceTypeCode` (string)
    Type code for a creditor reference.
    Enum: "radm", "rpin", "fxdr", "disp", "puor", "scor"

  - `remittanceInformationStructured.creditorReferenceInformation.referenceTypeProprietary` (string,null)
    Proprietary reference type.

  - `remittanceInformationStructured.creditorReferenceInformation.referenceIssuer` (string,null)
    Issuer of the reference.

  - `remittanceInformationStructured.additionalRemittanceInformation` (array)
    Additional remittance information lines.

  - `purposeCode` (string,null)
    ISO 20022 ExternalPurpose1Code.

  - `purposeProprietary` (string,null)
    Proprietary purpose code.

  - `bankTransactionCode` (string,null)
    ISO 20022 bank transaction code.

  - `bankTransactionCodeProprietary` (string,null)
    Proprietary bank transaction code.

  - `additionalInformation` (string,null)
    Additional information provided by the ASPSP.

  - `entryDetailsCount` (integer)
    Count of entry details (batch entries).

  - `transactionSource` (string)
    Source of the transaction.
    Enum: "Default", "CreditDebitNotification", "Statement"

  - `_links` (object)
    HATEOAS links.

  - `_links.self` (object)
    A HATEOAS link.

  - `_links.self.href` (string)
    URI of the linked resource.

  - `_links.self.verb` (string)
    HTTP verb for the link.
    Enum: "get", "post", "put", "delete"