# Transfer money between accounts

Performs a payment transaction from one account to another.

All fields are required.

Example request:
json
{
  "metaData": {
    "idempotencyKey": "partnerId_uuid",
    "partnerId": "partner-id",
    "partnerUserRef": "partner-user-id"
  },
  "payload": {
    "transactionAmount": 600,
    "transactionDate": "YYYY-MM-DD",
    "paymentTypeId": 1,
    "note": "note",
    "reasonForBlock": "reasonForBlock",
    "dateFormat": "yyyy-MM-dd",
    "locale": "en",
    "accountId": "6c9083ce-b9d6-4415-8ad1-e32050fc8f93",
    "clientTxId": "23da476e-0022-434d-96f0-18ce700c291a",
    "ref": "This funds are for testing only, not for personal use Ruth",
    "ownRef": "Sending test funds to Saga",
    "accountNumber": "62000004947",
    "branchCode": "006754",
    "name": "Ruth",
    "payAndClear": true,
    "notificationEmail": "notification_email",
    "notificationName": "notification_name",
    "beneficiaryId": "beneficiary_id",
    "beneficiaryVersion": 1
  }
}

Endpoint: POST /transactions/transfer
Version: 1.0.0

## Request fields (application/json):

  - `metaData` (object, required)
    Standard metadata supplied with each partner request.

  - `metaData.idempotencyKey` (string, required)
    Unique idempotency key for the request.
    Example: "partnerId_uuid"

  - `metaData.partnerId` (string, required)
    Partner identifier.
    Example: "partner-id"

  - `metaData.partnerUserRef` (string, required)
    Partner-side user reference.
    Example: "partner-user-id"

  - `payload` (object, required)
    Operation-specific payload.
    Example: {"accountId":"6c9083ce-b9d6-4415-8ad1-e32050fc8f93"}

## Response 200 fields (application/json):

  - `transactionData` (object, required)
    Summary information about a saga transaction.

  - `transactionData.transactionId` (integer, required)
    Internal transaction identifier.
    Example: 1

  - `transactionData.transactionType` (string, required)
    Type of transaction performed.
    Example: "TRANSFER"

  - `transactionData.transactionStatus` (string, required)
    Current transaction status.
    Example: "COMPLETED"

  - `transactionData.failedStep` (string,null)
    Name of the failed saga step when applicable.
    Example: "BANK_SUBMITTED"

  - `payload` (object, required)
    Operation-specific response payload.
    Example: {"cardId":"97c89895-372b-48ee-81c4-3230b4dbb6fd"}