Create Single Payouts

Create a single payout transactions

/request
POST https://staging-eagle.kongapay.com/request/payout/single-payout

This endpoint allows you to send a single payout transaction

# Headers

Name
Type
Description

Basic Auth

string

Username / Password

Content-Type

string

Set value to application/json

Request Body

Name
Type
Description

reference

string

Unique transaction identifier

amount

decimal

Total amount for transaction in kobo

recipientName

string

Beneficiary Name

recipientAccountNumber

string

Beneficiary Account Number

description

string

Transaction Note

institutionCode

string

Beneficiary Bank Code

Request


```postman_json
{
  "amount": 10,
  "reference": "seamless-ref-02",
  "recipientName": "IFEANYI OKERE",
  "recipientAccountNumber": "10000000702",
  "institutionCode": "999999",
  "description": "Single Payout"
}
```

Response

{
    "account": "1000572816",
    "user": "56095",
    "transaction_type_id": 5,
    "reference": "seamless-ref-02",
    "amount": 10,
    "payload": "{\"recipientName\":\"IFEANYI OKERE\",\"recipientAccountNumber\":\"10000000702\",\"institutionCode\":\"999999\",\"description\":\"Single Payout\"}",
    "next_stage_id": null,
    "id": 429,
    "status": "processing",
    "created_at": "2024-06-14T13:01:15.527Z",
    "updated_at": "2024-06-14T13:01:15.000Z",
    "processes": [
        {
            "id": 499,
            "transaction_id": 429,
            "amount": "10.00",
            "internal_reference": "KNIP-1718370075552-Y2tgy",
            "receipt": "KP-FqWC6-1718370087-kon",
            "processor": "Knip",
            "job_id": null,
            "status": "confirming",
            "payload": "{\"reference\":\"seamless-ref-02\",\"amount\":\"10.00\",\"recipientName\":\"IFEANYI OKERE\",\"recipientAccountNumber\":\"10000000702\",\"description\":\"Single Payout\",\"institutionCode\":\"999999\"}",
            "validation": null,
            "validation_status": "not-validated",
            "response": "{\"message\":\"transaction created successfully\",\"payment_reference\":\"KP-FqWC6-1718370087-kon\",\"status\":\"transaction_monitoring\",\"provider_reference\":\"\",\"created_at\":\"2024-06-14 13:01:20\",\"session_id\":null,\"transaction_cost\":0,\"net_amount\":10,\"external_reference\":\"seamless-ref-02\"}",
            "execution_count": 1,
            "tsq_response": null,
            "error": null,
            "tsq_count": 0,
            "processing_started_at": "2024-06-14T13:01:16.000Z",
            "processing_ended_at": "2024-06-14T13:01:21.000Z",
            "created_at": "2024-06-14T13:01:15.555Z",
            "updated_at": "2024-06-14T13:01:20.000Z"
        }
    ],
    "request_id": 583689
}
 

Last updated