# Create a credit clearing transaction

Creates a credit clearing transaction on the account specified in the request URL. The funds will be sent  this account  the account defined in the clearing profile sent in the request body.

Endpoint: POST /v1/accounts/{account_id}/credit_clearing_transactions
Version: 1.0

## Path parameters:

  - `account_id` (string, required)

## Request fields (application/json):

  - `amount` (object, required)
    The amount to withdraw from the account in the URL.
    Example: {"value":1000,"currency":"EUR","unit":"cents"}

  - `amount.value` (integer)
    The amount value.
    Example: 1000

  - `amount.unit` (string)
    The unit of the given value in cents.
    Example: "cents"

  - `amount.currency` (string)
    The currency of the given value. Only EUR is currently supported.
    Example: "EUR"

  - `booking_type` (string, required)
    The booking type to use for the transaction. Must match one of the booking types defined in the clearing profile.
    Enum: "CANCELLATION_BOOKING", "CancellationCardTransaction", "CANCELLATION_CARD_TRANSACTION_DIRECT", "CANCELLATION_CHARGE_CARD", "CANCELLATION_CHARGE_DUNNING", "CANCELLATION_CHARGE_SEPA_DIRECT_DEBIT_RETURN", "CANCELLATION_CRYPTO_EXCHANGE", "CANCELLATION_CURRENCY_EXCHANGE_PARTNER", "CANCELLATION_DIRECT_DEBIT", "CANCELLATION_DOUBLE_BOOKING", "CANCELLATION_INTERNAL_TRANSFER", "CANCELLATION_INTERNATIONAL_CREDIT_TRANSFER", "CANCELLATION_INTEREST_ACCRUED", "CANCELLATION_INTEREST_ANNUITY", "CANCELLATION_INTEREST_LOAN", "CANCELLATION_LOAN_PAYOUT", "CANCELLATION_REBOOKING", "CANCELLATION_REBOOKING_INTEREST", "CANCELLATION_SEPA_CREDIT_TRANSFER_RETURN", "CANCELLATION_SEPA_DIRECT_DEBIT", "CANCELLATION_SEPA_DIRECT_DEBIT_RETURN", "CANCELLATION_TRANSFER_ANNUITY", "CARD_DIRECT_DEBIT", "CARD_TRANSACTION", "CARD_TRANSACTION_DIRECT", "CASH_DEPOSIT_RETAIL", "CASH_WITHDRAWAL_RETAIL", "CHARGE_ACCOUNT_MAINTENANCE", "CHARGE_CARD", "CHARGE_DUNNING", "ChargeRecallRequest", "CHARGE_SEPA_DIRECT_DEBIT_RETURN", "ClosureBalanceTransfer", "COMMISSION_OVERDRAFT", "CREDIT_TRANSFER_CANCELLATION", "CRYPTO_EXCHANGE", "CURRENCY_EXCHANGE_PARTNER", "DIRECT_DEBIT", "FOREIGN_PAYMENT", "INTEREST_ACCRUED", "INTEREST_ANNUITY", "INTEREST_LOAN", "INTERNAL_TRANSFER", "INTERNATIONAL_CREDIT_TRANSFER", "LOAN_PAYOUT", "REBOOKING", "REBOOKING_INTEREST", "SEPA_CREDIT_TRANSFER", "SEPA_CREDIT_TRANSFER_RETURN", "SEPA_DIRECT_DEBIT", "SEPA_DIRECT_DEBIT_RETURN", "SepaInstantCreditTransfer", "TARGET2_CREDIT_TRANSFER", "TRANSFER_ANNUITY", "OTHER", "CASH_WITHDRAWAL_FEE", "CURRENCY_CASH_WITHDRAWAL_FEE", "CASH_DEPOSIT_RETAIL_FEE", "CASH_WITHDRAWAL_RETAIL_FEE", "CHARGE_CARD_DELIVERY_FEE", "CARD_ISSUANCE_FEE", "BOOSTER_PACKAGE_FEE", "ACCOUNT_MAINTENANCE_FEE", "ChargeVirtualCard", "ChargeReissuePhysicalCard", "ChargeAdditionalPhysicalCard", "ChargeAdditionalVirtualCard", "ChargeReissueVirtualCard", "ChargeCardMaintenance", "ChargeTopUpCard", "ChargeAdditionalAccountMaintenance", "ChargeSharedAccount", "ChargeAuthorizedUser", "ChargeGamblingTransactionPartner", "ChargeSEPAInstantOutgoing", "ChargeSEPAInstantIncoming", "ChargeManualSepaTransferPartner", "ChargeIncomingSwift", "ChargeGamblingOrCashEquivalent", "ChargeFXCardTransaction"

  - `clearing_profile_id` (string, required)
    ID of the clearing profile to use for the clearing transaction.
    Example: "1c0eda0b559825ef456b21d81f4ee962pacp"

  - `description` (string)
    A description for the credit clearing transaction, which will be visible to the account holder.
    Example: "Example clearing transaction"

  - `reference` (string)
    Optional unique transaction reference.
    Example: "ert123456789ert"

  - `initiator_reference` (string)
    Optional unique initiator reference.
    Example: "2603037c-e264-46c4-82e8-0d3ebc23a30f"

## Response 200 fields (application/json):

  - `id` (string)
    ID of the clearing transaction.
    Example: "3f4e761f500e4c11a6627b4d90daaec4"

  - `status` (string)
    The status of the clearing transaction.
    Enum: "ACCEPTED", "DECLINED", "EXECUTED", "REVIEW_NEEDED", "CANCELED"

  - `account_id` (string)
    ID of the account for which the transaction was created.
    Example: "06659ff514934b28800b5650d109cacc"

  - `account_iban` (string)
    The account's IBAN.
    Example: "DE43110101005555555555"

  - `clearing_account_iban` (string)
    The clearing account's IBAN.
    Example: "DE30110101001234567890"

  - `amount` (object)
    The amount of the transaction.

  - `amount.value` (integer)
    The amount value.
    Example: 1000

  - `amount.unit` (string)
    The unit of the given value in cents.
    Example: "cents"

  - `amount.currency` (string)
    The currency of the given value. Only EUR is currently supported.
    Example: "EUR"

  - `description` (string)
    A description of the transaction, which is visible to both the sender and the receiver.
    Example: "Example description"

  - `booking_type` (string)
    The type of the booking. See the [booking documentation](https://docs.solarisgroup.com/guides/digital-banking/account-management/#appendix-i-booking-types) for a list of explanations for each booking type.
    Enum: "CANCELLATION_BOOKING", "CancellationCardTransaction", "CANCELLATION_CARD_TRANSACTION_DIRECT", "CANCELLATION_CHARGE_CARD", "CANCELLATION_CHARGE_DUNNING", "CANCELLATION_CHARGE_SEPA_DIRECT_DEBIT_RETURN", "CANCELLATION_CRYPTO_EXCHANGE", "CANCELLATION_CURRENCY_EXCHANGE_PARTNER", "CANCELLATION_DIRECT_DEBIT", "CANCELLATION_DOUBLE_BOOKING", "CANCELLATION_INTERNAL_TRANSFER", "CANCELLATION_INTERNATIONAL_CREDIT_TRANSFER", "CANCELLATION_INTEREST_ACCRUED", "CANCELLATION_INTEREST_ANNUITY", "CANCELLATION_INTEREST_LOAN", "CANCELLATION_LOAN_PAYOUT", "CANCELLATION_REBOOKING", "CANCELLATION_REBOOKING_INTEREST", "CANCELLATION_SEPA_CREDIT_TRANSFER_RETURN", "CANCELLATION_SEPA_DIRECT_DEBIT", "CANCELLATION_SEPA_DIRECT_DEBIT_RETURN", "CANCELLATION_TRANSFER_ANNUITY", "CARD_DIRECT_DEBIT", "CARD_TRANSACTION", "CARD_TRANSACTION_DIRECT", "CASH_DEPOSIT_RETAIL", "CASH_WITHDRAWAL_RETAIL", "CHARGE_ACCOUNT_MAINTENANCE", "CHARGE_CARD", "CHARGE_DUNNING", "ChargeRecallRequest", "CHARGE_SEPA_DIRECT_DEBIT_RETURN", "ClosureBalanceTransfer", "COMMISSION_OVERDRAFT", "CREDIT_TRANSFER_CANCELLATION", "CRYPTO_EXCHANGE", "CURRENCY_EXCHANGE_PARTNER", "DIRECT_DEBIT", "FOREIGN_PAYMENT", "INTEREST_ACCRUED", "INTEREST_ANNUITY", "INTEREST_LOAN", "INTERNAL_TRANSFER", "INTERNATIONAL_CREDIT_TRANSFER", "LOAN_PAYOUT", "REBOOKING", "REBOOKING_INTEREST", "SEPA_CREDIT_TRANSFER", "SEPA_CREDIT_TRANSFER_RETURN", "SEPA_DIRECT_DEBIT", "SEPA_DIRECT_DEBIT_RETURN", "SEPAInstantCreditTransfer", "SepaInstantCreditTransferReturn", "TARGET2_CREDIT_TRANSFER", "TRANSFER_ANNUITY", "OTHER"

  - `valuta_date` (string)
    The valuta date of the transaction.
    Example: "2022-04-22"

  - `transaction_type` (string)
    The type of the transaction.
    Example: "CLEARING_TRANSACTION"

  - `reference` (string)
    UUID reference for the transaction. Acts as an idempotency key.
    Example: "2603037c-e264-46c4-82e8-0d3ebc23a30f"

  - `initiator_reference` (string)
    UUID initiatiors reference for the transaction.
    Example: "2603037c-e264-46c4-82e8-0d3ebc23a30f"

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

  - `code` (string)
    Example: "model_not_found"

  - `title` (string)
    Example: "Model Not Found"

  - `detail` (string)
    Example: "Couldn't find 'Solaris::Identification' for id 'bbbcccfff388923eb899a5852df6cidt'."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."