# Submit encrypted credit note

Submits an encrypted credit note to the queue for delivery to customer devices. The credit note is encrypted with customer device keys for end-to-end privacy.

Accessible for: Company, Client Application

Endpoint: POST /credit-note/encrypted
Version: v1
Security: cheqi_oauth

## Request fields (application/json):

  - `matchId` (string, required)
    The match id that you received during customer matching
    Example: "match_123456789"

  - `parentCheqiReceiptId` (string, required)
    The parent Cheqi this credit note refers to
    Example: "CHQ-1234567-123456-123456"

  - `encryptedCreditNotes` (array, required)
    A set of encrypted credit notes

  - `encryptedCreditNotes.recipientId` (string, required)
    The recipient ID of the credit note

  - `encryptedCreditNotes.creditNoteId` (string)
    The credit note ID
    Example: "UUID"

  - `encryptedCreditNotes.originalReceiptId` (string)
    The original receipt ID
    Example: "UUID"

  - `encryptedCreditNotes.receiverType` (string)
    The receiver type of the credit note
    Enum: "WEBHOOK", "DEVICE"

  - `encryptedCreditNotes.encryptedCreditNote` (string, required)
    The encrypted credit note
    Example: "encryptedCreditNote"

  - `encryptedCreditNotes.encryptedSymmetricKey` (string, required)
    Base64-encoded device-specific encrypted symmetric key

  - `encryptedCreditNotes.encryptedCustomerDetails` (string, required)
    Base64-encoded encrypted customer details.

  - `encryptedCreditNotes.encryptedCustomerAesKey` (string, required)
    Base64-encoded encrypted customer details AES key

  - `encryptedCreditNotes.finalHash` (string)

  - `encryptedCreditNotes.publicKey` (string, required)
    Base64-encoded public key used to encrypt the request

  - `encryptedCreditNotes.supplierPartyId` (string, required)
    Supplier party ID for storage

  - `templateHash` (string, required)
    The hash of the credit note template

## Response 201 fields (*/*):

  - `cheqiReceiptId` (string)
    The Cheqi receipt ID of the credit note
    Example: "CHQ-CREDIT-12345678-123456-123456"

  - `parentCheqiReceiptId` (string)
    The Cheqi receipt ID of the parent receipt
    Example: "CHQ-12345678-123456-123456"

  - `templateHash` (string)
    The hash of the credit note template
    Example: "9a39f25618892cc6d2ca6cd651af864543a34e7ee5b5c3efff6b0de3437a8383"

  - `createdAt` (string)
    The timestamp of the credit note creation
    Example: "1970-01-01T00:00:00Z"

## Response 400 fields (*/*):

  - `cheqiReceiptId` (string)
    The Cheqi receipt ID of the credit note
    Example: "CHQ-CREDIT-12345678-123456-123456"

  - `parentCheqiReceiptId` (string)
    The Cheqi receipt ID of the parent receipt
    Example: "CHQ-12345678-123456-123456"

  - `templateHash` (string)
    The hash of the credit note template
    Example: "9a39f25618892cc6d2ca6cd651af864543a34e7ee5b5c3efff6b0de3437a8383"

  - `createdAt` (string)
    The timestamp of the credit note creation
    Example: "1970-01-01T00:00:00Z"

## Response 403 fields (*/*):

  - `cheqiReceiptId` (string)
    The Cheqi receipt ID of the credit note
    Example: "CHQ-CREDIT-12345678-123456-123456"

  - `parentCheqiReceiptId` (string)
    The Cheqi receipt ID of the parent receipt
    Example: "CHQ-12345678-123456-123456"

  - `templateHash` (string)
    The hash of the credit note template
    Example: "9a39f25618892cc6d2ca6cd651af864543a34e7ee5b5c3efff6b0de3437a8383"

  - `createdAt` (string)
    The timestamp of the credit note creation
    Example: "1970-01-01T00:00:00Z"