Skip to main content
POST
/
momo-transfers
Creates a mobile money transfer payment for the authenticated user or entity.
curl --request POST \
  --url https://api.nuvion.tech/momo-transfers \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "currency": "GHS",
  "amount": 10000,
  "account_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
  "narration": "Payment for services",
  "counterparty_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F4",
  "unique_reference": "MOMO-TR-123456789",
  "meta": {
    "notes": "Additional payment information"
  }
}
'
{
  "message": "MOMO transfer payment created successfully",
  "status": 201,
  "data": {
    "id": "01HJ5G6R7MXW5ZK2QD6YA8N9F3",
    "amount": 10000,
    "currency": "GHS",
    "unique_reference": "MOMO-TR-123456789",
    "counterparty_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F4",
    "account_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
    "entity_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F6",
    "status": "pending",
    "status_reason": "awaiting_processing",
    "narration": "Payment for services",
    "type": "outflow",
    "applicable_fee": 200,
    "meta": {},
    "created": 1631456789000,
    "updated": 1631456789000
  }
}

Headers

​
Authorization
string
required

Authorization header: Bearer {jwt or Secretkey}

Body

application/json
​
currency
string
required

The currency code for the MOMO transfer

​
amount
number
required

The amount to transfer in the smallest currency unit (e.g., pesewas for GHS)

​
account_id
string
required

The unique identifier (ULID) of the account to debit for the MOMO transfer

​
narration
string
required

A description or reason for the MOMO transfer

​
counterparty_id
string
required

The unique identifier (ULID) of the recipient counterparty for the MOMO transfer

​
unique_reference
string
required

A unique reference code for this particular transfer

​
meta
object

Additional metadata to store with the MOMO transfer

Response

Created successfully

​
message
string
required

A descriptive message indicating the result of the operation

​
status
string
required

The status of the API operation (successful, error, failed, pending)

​
data
object
required

Contains the details of the created MOMO transfer