NUBAN Bulk Payouts

The NUBAN Bulk Payouts API allows you to initiate multiple NUBAN payouts across different payment channels in one request. It also allows you manage bulk payouts.

Create Bulk Payout

post

This endpoint initiates a bulk payout request with a JSON array.

It supports payouts with either the account number and bank code or the beneficiary payout option.

When the request is submitted, the payouts are then queued after which they will be individually initated and processed. You can query the endpoint to get a bulk payout by its UUID to see the status of the bulk payout and its individual payouts. You can also listen for the webhook to know when a bulk payout has been completely processed.

Authorizations

AuthenticationstringRequired

Body

payment_channelstringRequired

The payment channel to use for all the requests. Providing a payment_channel on a specific payout item overrides this value.

Responses

201Success

application/json

post

/v1/payouts/nuban/bulk

POST /v1/payouts/nuban/bulk HTTP/1.1
Authentication: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 300

{
  "payouts": [
    {
      "account_number": "2117394416",
      "bank_code": "NB-00165",
      "description": "Testing the payouts",
      "payment_channel": "paystack",
      "amount": "28"
    },
    {
      "account_number": "2003841673",
      "bank_code": "NB-00093",
      "description": "Testing th payouts",
      "payment_channel": "flutterwave",
      "amount": "39",
      "currency": "NGN"
    }
  ]
}

201Success

{
  "message": "NUBAN bulk payout created successfully",
  "status": "success",
  "data": {
    "uuid": "d2b3d74e-557a-11f0-8068-0242ac120006",
    "reference": "AsBP-1741516652488388f2",
    "env_mode": "live",
    "initiated_on": "API",
    "initiator_ip": "172.18.0.1",
    "csv_file_url": null,
    "payload": [
      {
        "bank_code": "NB-00165",
        "account_number": "2117394416",
        "amount": "28",
        "currency": "NGN",
        "description": "Testing the payouts",
        "payment_channel": "paystack"
      },
      {
        "bank_code": "NB-00093",
        "account_number": "2003841673",
        "amount": "28",
        "currency": "NGN",
        "description": "Testing the payouts",
        "payment_channel": "paystack"
      }
    ],
    "status": "new",
    "meta_data": null,
    "total_amount": "56",
    "payout_type": "nuban",
    "created_at": "2025-06-30T06:24:05.000000Z",
    "updated_at": "2025-06-30T06:24:05.000000Z",
    "business": {
      "business_id": "a264ee84-9a0b-4434-b997-ce716dbf7cdf",
      "name": "Live Paystack",
      "env_mode": "live",
      "business_category": null,
      "base_currency": "NGN",
      "logo": null,
      "webhook_url": "https://webhook.site/3ac07b91-cce3-4fda-926c-808a575d13e3",
      "default_redirect_url": null,
      "enabled_webhooks": 1,
      "send_subscription_mails": 0,
      "created_at": "2024-12-17T12:21:51.000000Z",
      "updated_at": "2025-02-09T17:54:38.000000Z",
      "users": [
        {
          "uuid": "14b6e2bb-60a9-4508-9017-0056a0b26a3e",
          "first_name": "Eric",
          "last_name": "McWinNEr",
          "email": "[email protected]",
          "phone_number_code": null,
          "phone_number": null,
          "email_verified_at": "2024-12-17T12:21:40.000000Z",
          "timezone": "UTC",
          "enable_two_fa": 0,
          "last_login": "2025-06-19 17:30:30",
          "last_ip": "172.18.0.1",
          "created_at": "2024-12-17T12:17:50.000000Z",
          "updated_at": "2025-06-19T17:30:30.000000Z",
          "came_from_waitlist": 0,
          "two_fa_mode": "email"
        }
      ]
    }
  }
}

Create Bulk Payout from CSV

post

This endpoint initiates a bulk payout request with a CSV file.

It supports payouts with either the account number and bank code or the beneficiary payout option.

It expects a CSV file with the following format:

account_number, bank_code,beneficiary_payout_option_uuid, amount, currency, description, payment_channel

The required fields for each line are: payment_channel, description and amount. account_number and bank_code is required if beneficiary_payout_option_uuid is not present in any line.

When the CSV is uploaded and validated, the payouts are then queued after which they will be individually initated and processed. You can query the endpoint to get a bulk payout by its UUID to see the status of the bulk payout and its individual payouts. You can also listen for the webhook to know when a bulk payout has been completely processed.

Authorizations

AuthenticationstringRequired

Body

filestring · binaryOptionalExample:

file:///Users/ericmcwinner/Documents/Work/Projects/Work/Laravel/async-pay/storage/app/public/sample_nuban_bulk_payout.csv

Responses

201Success

application/json

post

/v1/payouts/nuban/bulk/csv

POST /v1/payouts/nuban/bulk/csv HTTP/1.1
Authentication: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 132

{
  "file": "file:///Users/ericmcwinner/Documents/Work/Projects/Work/Laravel/async-pay/storage/app/public/sample_nuban_bulk_payout.csv"
}

201Success

{
  "message": "NUBAN bulk payout created successfully",
  "status": "success",
  "data": {
    "uuid": "e4178157-556c-11f0-8068-0242ac120006",
    "reference": "AsBP-151516786225137625",
    "env_mode": "live",
    "initiated_on": "API",
    "initiator_ip": "172.18.0.1",
    "csv_file_url": "https://asyncpay-imgs.s3.amazonaws.com/a264ee84-9a0b-4434-b997-ce716dbf7cdf/images/u11RJYsHrKp8kVTLFqiqIvayI7IyEZaybgSci79n.csv",
    "payload": [
      {
        "bank_code": "NB-00165",
        "account_number": "2117394416",
        "amount": "38",
        "currency": "NGN",
        "description": "Testing the payouts",
        "payment_channel": "paystack"
      },
      {
        "bank_code": "NB-00093",
        "account_number": "2003841673",
        "amount": "10",
        "currency": "",
        "description": "Testing to Kuda",
        "payment_channel": "paystack"
      },
      {
        "bank_code": "NB-00093",
        "account_number": "2003841673",
        "amount": "10",
        "currency": "",
        "description": "Testing to Kuda",
        "payment_channel": "paystack"
      }
    ],
    "status": "new",
    "meta_data": null,
    "total_amount": "58",
    "payout_type": "nuban",
    "created_at": "2025-06-30T04:44:22.000000Z",
    "updated_at": "2025-06-30T04:44:22.000000Z",
    "business": {
      "business_id": "a264ee84-9a0b-4434-b997-ce716dbf7cdf",
      "name": "Live Paystack",
      "env_mode": "live",
      "business_category": null,
      "base_currency": "NGN",
      "logo": null,
      "webhook_url": "https://webhook.site/3ac07b91-cce3-4fda-926c-808a575d13e3",
      "default_redirect_url": null,
      "enabled_webhooks": 1,
      "send_subscription_mails": 0,
      "created_at": "2024-12-17T12:21:51.000000Z",
      "updated_at": "2025-02-09T17:54:38.000000Z"
    }
  }
}

List Bulk Payouts

get

Lists all the bulk payouts in a business

Authorizations

AuthenticationstringRequired

Responses

200Success

application/json

get

/v1/payouts/nuban/bulk

GET /v1/payouts/nuban/bulk HTTP/1.1
Authentication: YOUR_API_KEY
Accept: */*

200Success

{
  "message": "Bulk payouts fetched successfully",
  "status": "success",
  "data": [
    {
      "uuid": "d2b3d74e-557a-11f0-8068-0242ac120006",
      "reference": "AsBP-1741516652488388f2",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": null,
      "payload": [
        {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "28",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "28",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        }
      ],
      "status": "in_progress",
      "meta_data": null,
      "total_amount": "56",
      "payout_type": "nuban",
      "created_at": "2025-06-30T06:24:05.000000Z",
      "updated_at": "2025-06-30T06:24:07.000000Z"
    },
    {
      "uuid": "dd751588-5575-11f0-8068-0242ac120006",
      "reference": "AsBP-16211675125bb62585",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": null,
      "payload": [
        {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "28",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "28",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        }
      ],
      "status": "in_progress",
      "meta_data": null,
      "total_amount": "56",
      "payout_type": "nuban",
      "created_at": "2025-06-30T05:48:36.000000Z",
      "updated_at": "2025-06-30T05:48:40.000000Z"
    },
    {
      "uuid": "7bfeee3e-5575-11f0-8068-0242ac120006",
      "reference": "AsBP-12325612571c916620",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": null,
      "payload": [
        {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "28",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "28",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        }
      ],
      "status": "in_progress",
      "meta_data": null,
      "total_amount": "56",
      "payout_type": "nuban",
      "created_at": "2025-06-30T05:45:52.000000Z",
      "updated_at": "2025-06-30T05:45:56.000000Z"
    },
    {
      "uuid": "e4178157-556c-11f0-8068-0242ac120006",
      "reference": "AsBP-151516786225137625",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": "https://asyncpay-imgs.s3.amazonaws.com/a264ee84-9a0b-4434-b997-ce716dbf7cdf/images/u11RJYsHrKp8kVTLFqiqIvayI7IyEZaybgSci79n.csv",
      "payload": [
        {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "38",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        }
      ],
      "status": "completed",
      "meta_data": null,
      "total_amount": "58",
      "payout_type": "nuban",
      "created_at": "2025-06-30T04:44:22.000000Z",
      "updated_at": "2025-06-30T04:45:08.000000Z"
    },
    {
      "uuid": "74086bf2-555c-11f0-8068-0242ac120006",
      "reference": "AsBP-1512117206548a9096",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": "https://asyncpay-imgs.s3.amazonaws.com/a264ee84-9a0b-4434-b997-ce716dbf7cdf/images/S6nHXQAXpbi3AUtk7TCO6HSuYbrPpwsZBQAQxSbD.csv",
      "payload": [
        {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "38",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        }
      ],
      "status": "completed",
      "meta_data": null,
      "total_amount": "58",
      "payout_type": "nuban",
      "created_at": "2025-06-30T02:46:42.000000Z",
      "updated_at": "2025-06-30T02:52:10.000000Z"
    },
    {
      "uuid": "b26f41d5-555b-11f0-8068-0242ac120006",
      "reference": "AsBP-11257577121d60834e",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": null,
      "payload": [
        {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "38",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        }
      ],
      "status": "completed",
      "meta_data": null,
      "total_amount": "58",
      "payout_type": "nuban",
      "created_at": "2025-06-30T02:41:17.000000Z",
      "updated_at": "2025-06-30T02:52:08.000000Z"
    },
    {
      "uuid": "92546ed9-555b-11f0-8068-0242ac120006",
      "reference": "AsBP-112235572118383e93",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": null,
      "payload": [
        {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "38",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        }
      ],
      "status": "completed",
      "meta_data": null,
      "total_amount": "58",
      "payout_type": "nuban",
      "created_at": "2025-06-30T02:40:23.000000Z",
      "updated_at": "2025-06-30T02:52:06.000000Z"
    },
    {
      "uuid": "84d69d41-5559-11f0-8068-0242ac120006",
      "reference": "AsBP-11517532104b569661",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": null,
      "payload": [
        {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "38",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        }
      ],
      "status": "completed",
      "meta_data": null,
      "total_amount": "58",
      "payout_type": "nuban",
      "created_at": "2025-06-30T02:25:41.000000Z",
      "updated_at": "2025-06-30T02:52:04.000000Z"
    },
    {
      "uuid": "3db8fb60-5559-11f0-8068-0242ac120006",
      "reference": "AsBP-11222510275fe66010",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": null,
      "payload": [
        {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "38",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        }
      ],
      "status": "completed",
      "meta_data": null,
      "total_amount": "58",
      "payout_type": "nuban",
      "created_at": "2025-06-30T02:23:42.000000Z",
      "updated_at": "2025-06-30T02:52:01.000000Z"
    },
    {
      "uuid": "2ad14299-5559-11f0-8068-0242ac120006",
      "reference": "AsBP-102515701917556e15",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": null,
      "payload": [
        {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "38",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        }
      ],
      "status": "completed",
      "meta_data": null,
      "total_amount": "58",
      "payout_type": "nuban",
      "created_at": "2025-06-30T02:23:10.000000Z",
      "updated_at": "2025-06-30T02:51:59.000000Z"
    },
    {
      "uuid": "3796d6c0-5558-11f0-8068-0242ac120006",
      "reference": "AsBP-191482721756766989",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": null,
      "payload": [
        {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "38",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        }
      ],
      "status": "completed",
      "meta_data": null,
      "total_amount": "58",
      "payout_type": "nuban",
      "created_at": "2025-06-30T02:16:22.000000Z",
      "updated_at": "2025-06-30T02:51:56.000000Z"
    },
    {
      "uuid": "1adef385-5557-11f0-8068-0242ac120006",
      "reference": "AsBP-115347042191e64695",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": null,
      "payload": [
        {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "38",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        }
      ],
      "status": "completed",
      "meta_data": null,
      "total_amount": "58",
      "payout_type": "nuban",
      "created_at": "2025-06-30T02:08:24.000000Z",
      "updated_at": "2025-06-30T02:51:55.000000Z"
    },
    {
      "uuid": "253388cb-5537-11f0-8068-0242ac120006",
      "reference": "AsBP-117355872516266613",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": "https://asyncpay-imgs.s3.amazonaws.com/a264ee84-9a0b-4434-b997-ce716dbf7cdf/images/gXdts3WBRhrDsMy660qXrWkYRIT5guZuy41sj05z.csv",
      "payload": [
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        }
      ],
      "status": "completed",
      "meta_data": null,
      "total_amount": "20",
      "payout_type": "nuban",
      "created_at": "2025-06-29T22:19:38.000000Z",
      "updated_at": "2025-06-29T22:20:01.000000Z"
    },
    {
      "uuid": "e643d521-5536-11f0-8068-0242ac120006",
      "reference": "AsBP-117153225474cb6b83",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": "https://asyncpay-imgs.s3.amazonaws.com/a264ee84-9a0b-4434-b997-ce716dbf7cdf/images/AiwPWc0hOpj1SYcsCOrNbtfTePfj3H7PH3MZqjHx.csv",
      "payload": [
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        }
      ],
      "status": "completed",
      "meta_data": null,
      "total_amount": "20",
      "payout_type": "nuban",
      "created_at": "2025-06-29T22:17:52.000000Z",
      "updated_at": "2025-06-29T22:18:15.000000Z"
    },
    {
      "uuid": "60f760b1-5536-11f0-8068-0242ac120006",
      "reference": "AsBP-112275514398922750",
      "env_mode": "live",
      "initiated_on": "API",
      "initiator_ip": "172.18.0.1",
      "csv_file_url": "https://asyncpay-imgs.s3.amazonaws.com/a264ee84-9a0b-4434-b997-ce716dbf7cdf/images/L21OuvuWeK7Gxv8Sk7vZII4UKnDxV8raaH6fSPeF.csv",
      "payload": [
        {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "38",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        }
      ],
      "status": "completed",
      "meta_data": null,
      "total_amount": "48",
      "payout_type": "nuban",
      "created_at": "2025-06-29T22:14:09.000000Z",
      "updated_at": "2025-06-30T02:51:53.000000Z"
    }
  ]
}

Fetch Bulk Payout

get

This endpoint fetches the complete details of a bulk payout

Authorizations

AuthenticationstringRequired

Path parameters

BulkPayoutUUIDstringRequired

The UUID of the bulk payout we want to fetch

Responses

200Success

application/json

get

/v1/payouts/nuban/bulk/{BulkPayoutUUID}

GET /v1/payouts/nuban/bulk/{BulkPayoutUUID} HTTP/1.1
Authentication: YOUR_API_KEY
Accept: */*

200Success

{
  "message": "Bulk Payout fetched successfully",
  "status": "success",
  "data": {
    "uuid": "e4178157-556c-11f0-8068-0242ac120006",
    "reference": "AsBP-151516786225137625",
    "env_mode": "live",
    "initiated_on": "API",
    "initiator_ip": "172.18.0.1",
    "csv_file_url": "https://asyncpay-imgs.s3.amazonaws.com/a264ee84-9a0b-4434-b997-ce716dbf7cdf/images/u11RJYsHrKp8kVTLFqiqIvayI7IyEZaybgSci79n.csv",
    "payload": [
      {
        "bank_code": "NB-00165",
        "account_number": "2117394416",
        "amount": "38",
        "currency": "NGN",
        "description": "Testing the payouts",
        "payment_channel": "paystack"
      },
      {
        "bank_code": "NB-00093",
        "account_number": "2003841673",
        "amount": "10",
        "currency": "",
        "description": "Testing to Kuda",
        "payment_channel": "paystack"
      },
      {
        "bank_code": "NB-00093",
        "account_number": "2003841673",
        "amount": "10",
        "currency": "",
        "description": "Testing to Kuda",
        "payment_channel": "paystack"
      }
    ],
    "status": "completed",
    "meta_data": null,
    "total_amount": "58",
    "payout_type": "nuban",
    "created_at": "2025-06-30T04:44:22.000000Z",
    "updated_at": "2025-06-30T04:45:08.000000Z",
    "bulk_payout_items": [
      {
        "uuid": "e4b2580e-556c-11f0-8068-0242ac120006",
        "env_mode": "live",
        "payment_channel_slug": "paystack",
        "no_of_attempts": 1,
        "payload": {
          "bank_code": "NB-00165",
          "account_number": "2117394416",
          "amount": "38",
          "currency": "NGN",
          "description": "Testing the payouts",
          "payment_channel": "paystack"
        },
        "payout_type": "nuban",
        "status": "completed",
        "status_is_conclusive": 0,
        "last_attempted_at": "2025-06-30 04:44:25",
        "created_at": "2025-06-30T04:44:23.000000Z",
        "updated_at": "2025-06-30T04:45:07.000000Z",
        "payout": {
          "uuid": "e8662cda-556c-11f0-8068-0242ac120006",
          "ref": "AsPR-130061928530d8183626d",
          "env_mode": "live",
          "initiated_from": null,
          "type": "nuban",
          "is_one_time_beneficiary": 1,
          "bulk_payout_id": 49,
          "bulk_payout_item_id": 163,
          "amount": "38",
          "amount_to_usd": "0.0247",
          "payment_channel_slug": "paystack",
          "currency": "NGN",
          "description": "Testing the payouts",
          "status": "successful",
          "status_is_conclusive": 1,
          "status_summary": "Transfer was successful",
          "meta_data": null,
          "callback_url": null,
          "created_at": "2025-06-30T04:44:29.000000Z",
          "updated_at": "2025-06-30T04:45:05.000000Z",
          "transfer_ref": "AsNT-28986056d6686",
          "reference": "AsPR-130061928530d8183626d",
          "beneficiary": {
            "uuid": "3883d458-4f14-11f0-a0d2-0242ac120006",
            "beneficiary_id": "AsB-85052f7f277f2",
            "env_mode": "live",
            "name": "2117394416-NB-00165",
            "email": null,
            "created_at": "2025-06-22T02:54:31.000000Z",
            "updated_at": "2025-06-22T02:54:31.000000Z",
            "payouts_count": 54,
            "payout_options_count": 1
          },
          "beneficiary_payout_option": {
            "uuid": "38f8d6d5-4f14-11f0-a0d2-0242ac120006",
            "third_party_ids": {
              "paystack": "RCP_jt40sdh0yicd88b"
            },
            "env_mode": "live",
            "payment_method_code": "PMC-6778705529461",
            "created_at": "2025-06-22T02:54:32.000000Z",
            "updated_at": "2025-06-22T02:54:32.000000Z",
            "destination_type": "nuban",
            "destination": {
              "uuid": "6322dc93-3909-11f0-992c-0242ac120006",
              "env_mode": "live",
              "payment_channel_availability": {
                "paystack": true
              },
              "bank_code": "NB-00165",
              "account_number": "2117394416",
              "account_name": "ERIC OBELEDATE APRIOKU",
              "created_at": "2025-05-25T01:41:32.000000Z",
              "updated_at": "2025-06-04T04:37:33.000000Z",
              "bank": {
                "uuid": "3da26ac6-caeb-11ef-a3d3-0242ac130006",
                "bank_name": "Zenith Bank",
                "bank_slug": "zenith-bank",
                "bank_code": "NB-00165",
                "payment_channel_availability": {
                  "paystack": true,
                  "flutterwave": true
                },
                "created_at": "2025-01-04T22:28:37.000000Z",
                "updated_at": "2025-05-27T17:24:38.000000Z"
              }
            }
          },
          "initiated_by_user": null
        }
      },
      {
        "uuid": "e4b3bdf2-556c-11f0-8068-0242ac120006",
        "env_mode": "live",
        "payment_channel_slug": "paystack",
        "no_of_attempts": 1,
        "payload": {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        },
        "payout_type": "nuban",
        "status": "completed",
        "status_is_conclusive": 0,
        "last_attempted_at": "2025-06-30 04:44:37",
        "created_at": "2025-06-30T04:44:23.000000Z",
        "updated_at": "2025-06-30T04:45:07.000000Z",
        "payout": {
          "uuid": "eed58cc4-556c-11f0-8068-0242ac120006",
          "ref": "AsPR-1310317680e1986807682",
          "env_mode": "live",
          "initiated_from": null,
          "type": "nuban",
          "is_one_time_beneficiary": 1,
          "bulk_payout_id": 49,
          "bulk_payout_item_id": 164,
          "amount": "10",
          "amount_to_usd": "11.704",
          "payment_channel_slug": "paystack",
          "currency": "",
          "description": "Testing to Kuda",
          "status": "successful",
          "status_is_conclusive": 1,
          "status_summary": "Transfer was successful",
          "meta_data": null,
          "callback_url": null,
          "created_at": "2025-06-30T04:44:40.000000Z",
          "updated_at": "2025-06-30T04:45:07.000000Z",
          "transfer_ref": "AsNT-427988964b460",
          "reference": "AsPR-1310317680e1986807682",
          "beneficiary": {
            "uuid": "3a68cff9-4f14-11f0-a0d2-0242ac120006",
            "beneficiary_id": "AsB-773b9e7675b56",
            "env_mode": "live",
            "name": "2003841673-NB-00093",
            "email": null,
            "created_at": "2025-06-22T02:54:34.000000Z",
            "updated_at": "2025-06-22T02:54:34.000000Z",
            "payouts_count": 72,
            "payout_options_count": 1
          },
          "beneficiary_payout_option": {
            "uuid": "3b1808e0-4f14-11f0-a0d2-0242ac120006",
            "third_party_ids": {
              "paystack": "RCP_cw1o8x6usnkd4r2"
            },
            "env_mode": "live",
            "payment_method_code": "PMC-a199697476350",
            "created_at": "2025-06-22T02:54:35.000000Z",
            "updated_at": "2025-06-24T20:57:19.000000Z",
            "destination_type": "nuban",
            "destination": {
              "uuid": "bd41245e-fcb2-11ef-a015-0242ac120006",
              "env_mode": "live",
              "payment_channel_availability": {
                "paystack": true,
                "flutterwave": true
              },
              "bank_code": "NB-00093",
              "account_number": "2003841673",
              "account_name": "Eric Obeleoate Aprioku",
              "created_at": "2025-03-09T06:50:08.000000Z",
              "updated_at": "2025-06-22T02:54:34.000000Z",
              "bank": {
                "uuid": "3d8d494f-caeb-11ef-a3d3-0242ac130006",
                "bank_name": "Kuda Bank",
                "bank_slug": "kuda-bank",
                "bank_code": "NB-00093",
                "payment_channel_availability": {
                  "paystack": true,
                  "flutterwave": true
                },
                "created_at": "2025-01-04T22:28:37.000000Z",
                "updated_at": "2025-05-27T17:24:37.000000Z"
              }
            }
          },
          "initiated_by_user": null
        }
      },
      {
        "uuid": "e4b4d4de-556c-11f0-8068-0242ac120006",
        "env_mode": "live",
        "payment_channel_slug": "paystack",
        "no_of_attempts": 1,
        "payload": {
          "bank_code": "NB-00093",
          "account_number": "2003841673",
          "amount": "10",
          "currency": "",
          "description": "Testing to Kuda",
          "payment_channel": "paystack"
        },
        "payout_type": "nuban",
        "status": "completed",
        "status_is_conclusive": 0,
        "last_attempted_at": "2025-06-30 04:44:46",
        "created_at": "2025-06-30T04:44:23.000000Z",
        "updated_at": "2025-06-30T04:45:08.000000Z",
        "payout": {
          "uuid": "f40c0944-556c-11f0-8068-0242ac120006",
          "ref": "AsPR-1315d4678e72918714626",
          "env_mode": "live",
          "initiated_from": null,
          "type": "nuban",
          "is_one_time_beneficiary": 1,
          "bulk_payout_id": 49,
          "bulk_payout_item_id": 165,
          "amount": "10",
          "amount_to_usd": "11.704",
          "payment_channel_slug": "paystack",
          "currency": "",
          "description": "Testing to Kuda",
          "status": "successful",
          "status_is_conclusive": 1,
          "status_summary": "Transfer was successful",
          "meta_data": null,
          "callback_url": null,
          "created_at": "2025-06-30T04:44:48.000000Z",
          "updated_at": "2025-06-30T04:45:08.000000Z",
          "transfer_ref": "AsNT-f666222048656",
          "reference": "AsPR-1315d4678e72918714626",
          "beneficiary": {
            "uuid": "3a68cff9-4f14-11f0-a0d2-0242ac120006",
            "beneficiary_id": "AsB-773b9e7675b56",
            "env_mode": "live",
            "name": "2003841673-NB-00093",
            "email": null,
            "created_at": "2025-06-22T02:54:34.000000Z",
            "updated_at": "2025-06-22T02:54:34.000000Z",
            "payouts_count": 72,
            "payout_options_count": 1
          },
          "beneficiary_payout_option": {
            "uuid": "3b1808e0-4f14-11f0-a0d2-0242ac120006",
            "third_party_ids": {
              "paystack": "RCP_cw1o8x6usnkd4r2"
            },
            "env_mode": "live",
            "payment_method_code": "PMC-a199697476350",
            "created_at": "2025-06-22T02:54:35.000000Z",
            "updated_at": "2025-06-24T20:57:19.000000Z",
            "destination_type": "nuban",
            "destination": {
              "uuid": "bd41245e-fcb2-11ef-a015-0242ac120006",
              "env_mode": "live",
              "payment_channel_availability": {
                "paystack": true,
                "flutterwave": true
              },
              "bank_code": "NB-00093",
              "account_number": "2003841673",
              "account_name": "Eric Obeleoate Aprioku",
              "created_at": "2025-03-09T06:50:08.000000Z",
              "updated_at": "2025-06-22T02:54:34.000000Z",
              "bank": {
                "uuid": "3d8d494f-caeb-11ef-a3d3-0242ac130006",
                "bank_name": "Kuda Bank",
                "bank_slug": "kuda-bank",
                "bank_code": "NB-00093",
                "payment_channel_availability": {
                  "paystack": true,
                  "flutterwave": true
                },
                "created_at": "2025-01-04T22:28:37.000000Z",
                "updated_at": "2025-05-27T17:24:37.000000Z"
              }
            }
          },
          "initiated_by_user": null
        }
      }
    ]
  }
}

PreviousNUBAN Payouts NextMisc

Last updated 7 months ago

hashtagCreate Bulk Payout

hashtagCreate Bulk Payout from CSV

hashtagList Bulk Payouts

hashtagFetch Bulk Payout

Create Bulk Payout

Create Bulk Payout from CSV

List Bulk Payouts

Fetch Bulk Payout