v1

latestOpenAPI 3.1.02026-07-26590236.8 KB

Create Conversion

post/conversion

Request body

currency_source'USD' | 'NGN' required

currency_destination'NGN' | 'USD' required

amount_sourceinteger required

Response

201

messagestring

{"stackTrail":"paths:/conversion:post:responses:201:content:application/json:schema:properties:meta","oasType":"schema","type":"unknown"}

statusstring

Example response

{
  "data": {
    "conversion": {
      "id": "0af8cdc5146611f0b8d20edcd86e5ab3",
      "source_account_id": "fb7a4d70e91511ed97c982e65b002663",
      "destination_account_id": "487234c1b08011ed97c982e65b002663",
      "source_type": "wallet_account",
      "destination_type": "wallet_account",
      "currency_source": "NGN",
      "currency_destination": "USD",
      "amount_source": 2000000,
      "amount_destination": 1295,
      "rate": 1544,
      "status": "queued",
      "created_at": "2025-04-08T10:41:35Z",
      "updated_at": "2025-04-08T10:41:35Z"
    },
    "transaction": {
      "id": "0afa4b55146611f0b8d20edcd86e5ab3",
      "organisation_id": "8dbe79d36c1011ed8cc5dacad92d8272",
      "object_type": "account",
      "account_id": "fb7a4d70e91511ed97c982e65b002663",
      "account_type": "wallet_account",
      "kind": "conversion",
      "conversion_id": "0af8cdc5146611f0b8d20edcd86e5ab3",
      "type": "debit",
      "description": "Conversion transaction to USD",
      "currency": "NGN",
      "amount": 2000000,
      "status": "pending",
      "created_at": "2025-04-08T10:41:35Z",
      "updated_at": "2025-04-08T10:41:35Z"
    }
  },
  "message": "Conversion queued successfully",
  "status": "success"
}