Sign in
Partner remittances

Create a partner remittance

Creates a partner remittance transaction for the account specified in the request URL. Note that this endpoint requires a change request.

post/v1/accounts/{account_id}/partner_remittances

Path parameters

account_idstring required

Request body

receiver_first_namestring

The receiver's first name.

receiver_last_namestring

The receiver's last name.

receiver_account_numberstring

The receiver's bank account number.

descriptionstring

Optional description of the remittance, which will be visible to the recipient.

clearing_profile_idstring

ID of the clearing profile to use for this transaction.

booking_type'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'

The type of the booking. See the booking documentation for a list of explanations for each booking type.

referencestring

A unique transaction reference

Example request

{
  "receiver_first_name": "Peter",
  "receiver_last_name": "Testmann",
  "receiver_address": {
    "line_1": "Musterstrasse 64",
    "line_2": "Musterstrasse 64",
    "postal_code": "10409",
    "city": "Berlin",
    "country": "DE",
    "state": "BE"
  },
  "receiver_account_number": "DE72110101001000014344",
  "amount": {
    "value": 1000,
    "currency": "EUR",
    "unit": "cents"
  },
  "description": "Purpose of the transaction",
  "clearing_profile_id": "1c0eda0b559825ef456b21d81f4ee962pacp",
  "booking_type": "INTERNAL_TRANSFER",
  "reference": "ert123456789ert"
}

Response

Unexpected error