curl --request PUT \
--url http://localhost:3001/api/v1/business/payouts/schedules/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"payload": {
"items": [
{
"currency": "<string>",
"recipientId": "<string>",
"srcAmount": "50.00",
"dstAmount": "50000",
"reference": "<string>"
}
]
},
"name": "<string>",
"maxRunAmountUsd": 50000,
"pin": "<string>",
"maxRunLocalCaps": [
{
"currency": "NGN",
"amount": "20000000"
}
]
}
'import requests
url = "http://localhost:3001/api/v1/business/payouts/schedules/{id}"
payload = {
"payload": { "items": [
{
"currency": "<string>",
"recipientId": "<string>",
"srcAmount": "50.00",
"dstAmount": "50000",
"reference": "<string>"
}
] },
"name": "<string>",
"maxRunAmountUsd": 50000,
"pin": "<string>",
"maxRunLocalCaps": [
{
"currency": "NGN",
"amount": "20000000"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
payload: {
items: [
{
currency: '<string>',
recipientId: '<string>',
srcAmount: '50.00',
dstAmount: '50000',
reference: '<string>'
}
]
},
name: '<string>',
maxRunAmountUsd: 50000,
pin: '<string>',
maxRunLocalCaps: [{currency: 'NGN', amount: '20000000'}]
})
};
fetch('http://localhost:3001/api/v1/business/payouts/schedules/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3001",
CURLOPT_URL => "http://localhost:3001/api/v1/business/payouts/schedules/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'payload' => [
'items' => [
[
'currency' => '<string>',
'recipientId' => '<string>',
'srcAmount' => '50.00',
'dstAmount' => '50000',
'reference' => '<string>'
]
]
],
'name' => '<string>',
'maxRunAmountUsd' => 50000,
'pin' => '<string>',
'maxRunLocalCaps' => [
[
'currency' => 'NGN',
'amount' => '20000000'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://localhost:3001/api/v1/business/payouts/schedules/{id}"
payload := strings.NewReader("{\n \"payload\": {\n \"items\": [\n {\n \"currency\": \"<string>\",\n \"recipientId\": \"<string>\",\n \"srcAmount\": \"50.00\",\n \"dstAmount\": \"50000\",\n \"reference\": \"<string>\"\n }\n ]\n },\n \"name\": \"<string>\",\n \"maxRunAmountUsd\": 50000,\n \"pin\": \"<string>\",\n \"maxRunLocalCaps\": [\n {\n \"currency\": \"NGN\",\n \"amount\": \"20000000\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("http://localhost:3001/api/v1/business/payouts/schedules/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"payload\": {\n \"items\": [\n {\n \"currency\": \"<string>\",\n \"recipientId\": \"<string>\",\n \"srcAmount\": \"50.00\",\n \"dstAmount\": \"50000\",\n \"reference\": \"<string>\"\n }\n ]\n },\n \"name\": \"<string>\",\n \"maxRunAmountUsd\": 50000,\n \"pin\": \"<string>\",\n \"maxRunLocalCaps\": [\n {\n \"currency\": \"NGN\",\n \"amount\": \"20000000\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:3001/api/v1/business/payouts/schedules/{id}")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"payload\": {\n \"items\": [\n {\n \"currency\": \"<string>\",\n \"recipientId\": \"<string>\",\n \"srcAmount\": \"50.00\",\n \"dstAmount\": \"50000\",\n \"reference\": \"<string>\"\n }\n ]\n },\n \"name\": \"<string>\",\n \"maxRunAmountUsd\": 50000,\n \"pin\": \"<string>\",\n \"maxRunLocalCaps\": [\n {\n \"currency\": \"NGN\",\n \"amount\": \"20000000\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": "<string>",
"businessId": "<string>",
"name": "<string>",
"itemCount": 123,
"nextRunAt": "<string>",
"runCount": 123,
"maxRunAmountUsd": "<string>",
"authorizedAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"dayOfMonth": {},
"lastRunAt": {},
"endAt": {},
"maxRunLocalCaps": [
{
"currency": "NGN",
"amount": "20000000"
}
]
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}Edit (re-authorize) a scheduled payout
Replaces the recipient list / amounts (new hire, resignation, raise) WITHOUT recreating the schedule — the cadence, day-of-month and nextRunAt timing are preserved. Every edit re-authorizes: it re-validates the payload + per-run cap, sanctions-screens every recipient in the new payload, re-verifies the transaction PIN on the dashboard path (api-key exempt), and re-stamps authorizedAt/By. Only ACTIVE/PAUSED schedules are editable; changing the cadence/timing still requires recreating the schedule.
curl --request PUT \
--url http://localhost:3001/api/v1/business/payouts/schedules/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"payload": {
"items": [
{
"currency": "<string>",
"recipientId": "<string>",
"srcAmount": "50.00",
"dstAmount": "50000",
"reference": "<string>"
}
]
},
"name": "<string>",
"maxRunAmountUsd": 50000,
"pin": "<string>",
"maxRunLocalCaps": [
{
"currency": "NGN",
"amount": "20000000"
}
]
}
'import requests
url = "http://localhost:3001/api/v1/business/payouts/schedules/{id}"
payload = {
"payload": { "items": [
{
"currency": "<string>",
"recipientId": "<string>",
"srcAmount": "50.00",
"dstAmount": "50000",
"reference": "<string>"
}
] },
"name": "<string>",
"maxRunAmountUsd": 50000,
"pin": "<string>",
"maxRunLocalCaps": [
{
"currency": "NGN",
"amount": "20000000"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
payload: {
items: [
{
currency: '<string>',
recipientId: '<string>',
srcAmount: '50.00',
dstAmount: '50000',
reference: '<string>'
}
]
},
name: '<string>',
maxRunAmountUsd: 50000,
pin: '<string>',
maxRunLocalCaps: [{currency: 'NGN', amount: '20000000'}]
})
};
fetch('http://localhost:3001/api/v1/business/payouts/schedules/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3001",
CURLOPT_URL => "http://localhost:3001/api/v1/business/payouts/schedules/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'payload' => [
'items' => [
[
'currency' => '<string>',
'recipientId' => '<string>',
'srcAmount' => '50.00',
'dstAmount' => '50000',
'reference' => '<string>'
]
]
],
'name' => '<string>',
'maxRunAmountUsd' => 50000,
'pin' => '<string>',
'maxRunLocalCaps' => [
[
'currency' => 'NGN',
'amount' => '20000000'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://localhost:3001/api/v1/business/payouts/schedules/{id}"
payload := strings.NewReader("{\n \"payload\": {\n \"items\": [\n {\n \"currency\": \"<string>\",\n \"recipientId\": \"<string>\",\n \"srcAmount\": \"50.00\",\n \"dstAmount\": \"50000\",\n \"reference\": \"<string>\"\n }\n ]\n },\n \"name\": \"<string>\",\n \"maxRunAmountUsd\": 50000,\n \"pin\": \"<string>\",\n \"maxRunLocalCaps\": [\n {\n \"currency\": \"NGN\",\n \"amount\": \"20000000\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("http://localhost:3001/api/v1/business/payouts/schedules/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"payload\": {\n \"items\": [\n {\n \"currency\": \"<string>\",\n \"recipientId\": \"<string>\",\n \"srcAmount\": \"50.00\",\n \"dstAmount\": \"50000\",\n \"reference\": \"<string>\"\n }\n ]\n },\n \"name\": \"<string>\",\n \"maxRunAmountUsd\": 50000,\n \"pin\": \"<string>\",\n \"maxRunLocalCaps\": [\n {\n \"currency\": \"NGN\",\n \"amount\": \"20000000\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:3001/api/v1/business/payouts/schedules/{id}")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"payload\": {\n \"items\": [\n {\n \"currency\": \"<string>\",\n \"recipientId\": \"<string>\",\n \"srcAmount\": \"50.00\",\n \"dstAmount\": \"50000\",\n \"reference\": \"<string>\"\n }\n ]\n },\n \"name\": \"<string>\",\n \"maxRunAmountUsd\": 50000,\n \"pin\": \"<string>\",\n \"maxRunLocalCaps\": [\n {\n \"currency\": \"NGN\",\n \"amount\": \"20000000\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": "<string>",
"businessId": "<string>",
"name": "<string>",
"itemCount": 123,
"nextRunAt": "<string>",
"runCount": 123,
"maxRunAmountUsd": "<string>",
"authorizedAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"dayOfMonth": {},
"lastRunAt": {},
"endAt": {},
"maxRunLocalCaps": [
{
"currency": "NGN",
"amount": "20000000"
}
]
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "email must be an email",
"statusCode": 400,
"errors": {}
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Active business context
Merchant API key (alternative to dashboard JWT)
Path Parameters
Body
SINGLE | BATCH.
SINGLE, BATCH The replacement frozen payout spec (re-screened on edit).
Show child attributes
Show child attributes
New label (rename). Omit to keep the current name.
1 - 120Per-run USD cap (compliance). Defaults to SCHEDULE_RUN_USD_DEFAULT ($50k); rejected if above the SCHEDULE_RUN_USD_CEILING admin cap ($250k).
50000
Transaction PIN, required on the dashboard path to re-authorize the edit (verified server-side). Not required on the api-key path.
Optional per-currency caps for locally-denominated runs. A currency listed here is checked against the run total in that currency and is immune to FX movement; every other currency still falls under maxRunAmountUsd. Omit for USD-only capping (the existing behaviour).
Show child attributes
Show child attributes
