PUT
/
wallets
/
wallet
/
transaction
/
post
/
complete
curl --request PUT \
  --url https://waas-staging.cafeone.ng/api/v1/wallets/wallet/transaction/post/complete \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "transactionReference": "<string>",
  "walletId": "<string>",
  "customerId": "<string>",
  "organizationId": "<string>",
  "amount": 123,
  "accountNumber": "<string>",
  "isPosted": true
}'

​
Request Body

​
transactionReference
string

A unique reference for the transaction. Example: “TRX-2025-04-07-12345”

​
walletId
string
required

The unique identifier of the wallet involved in the transaction. Example: “3fa85f64-5717-4562-b3fc-2c963f66afa6”

​
customerId
string
required

The unique identifier of the customer who owns the wallet. Example: “3fa85f64-5717-4562-b3fc-2c963f66afa6”

​
organizationId
string
required

The unique identifier of the organization processing the transaction. Example: “3fa85f64-5717-4562-b3fc-2c963f66afa6”

​
amount
number
required

The transaction amount. Example: 4999940

​
accountNumber
string
required

The account number for the transaction. Example: “3023563113”

​
isPosted
boolean

Indicates whether the transaction has been posted.

  • true: Transaction has been posted
  • false: Transaction is pending

​
Response

✅ Success Response


Status Code: 200 OK
{
  "code": "200",
  "success": true,
  "message": "Transaction completed successfully.",
  "data": {
    // Additional data fields if applicable
  }
}

​
❌ Error Responses

Status Code: 400 Bad Request

{
  "code": "400",
  "success": false,
  "message": "Invalid request data",
  "data": null
}

Status Code: 404 Not Found

{
  "code": "404",
  "success": false,
  "message": "Invalid customer and organization",
  "data": null
}

Status Code: 500 Internal Server Error

{
  "code": "500",
  "success": false,
  "message": "An unexpected error occurred",
  "data": null
}