---
title: "POST /v1/transactions"
method: POST
path: "/v1/transactions"
tags: ["transactions"]
---

# POST /v1/transactions

`POST /v1/transactions`

## Request

- Base URL: `https://apibusiness-staging-civ.djamo.io`
- URL: `https://apibusiness-staging-civ.djamo.io/v1/transactions`
- Auth: HTTP bearer

## Request body

- TransactionParams
  - `msisdn` string, required: The recipient phone number.
  - `amount` number, required: The amount to send to the account
  - `reference` string, required: The unique identifier of the transaction on your side.
  - `description` string, required: Description for the receiver
  - `type` 'transfer', required: Type of the transaction
  - `metadata` object: Optional key-value pairs to attach additional information to the transaction.

## Response `200`

- Transaction
  - `id` string, required: Universal Unique Identifier for the object.
  - `createdAt` string, required: Date and time when the object was created. The API returns this value in ISO 8601 format.
  - `updatedAt` string, required: Date and time when the object was updated. The API returns this value in ISO 8601 format.
  - `amount` integer, required: The amount to transfer.
  - `fee` number, required: Fee applied.
  - `totalAmount` number, required: Total amount
  - `status` 'pending' | 'failed' | 'pending_provider' | 'completed', required: Status of the transaction
  - `msisdn` string, required: The recipient phone number.
  - `reference` string, required: The unique identifier of the transaction on your side.
  - `failureReason` string, required: The reason why the transaction has failed. Available only for failed transaction.
  - `description` string, required: Description for the receiver
  - `type` 'transfer', required: Transaction type.
  - `batchId` 'transfer', required: Unique identifier of the batch
  - `metadata` object: Key-value pairs attached to the transaction. `null` if none was provided.

## Other responses

- `400`

---

[API](https://skmtc.dev/djamo/apis/djamo-business-api-playground.md) - [All operations](https://skmtc.dev/djamo/apis/djamo-business-api-playground/llms.txt) - [OpenAPI document](https://skmtc.dev/djamo/apis/djamo-business-api-playground/revisions/e7f36f4cab53?raw)
