Mark payout request as paid

POST

payout_requests

{id}

mark_as_paid

curl --request POST \
  --url https://api.example.com/v1/payout_requests/{id}/mark_as_paid

const options = {method: 'POST'};

fetch('https://api.example.com/v1/payout_requests/{id}/mark_as_paid', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/payout_requests/{id}/mark_as_paid",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/payout_requests/{id}/mark_as_paid"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/payout_requests/{id}/mark_as_paid")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": 555,
    "partner": "partner_123",
    "status": "finished",
    "amount": 200.0,
    "amount_units": "usd",
    "payout_gateway": "paypal",
    "created_by": "api",
    "created_at": "2026-09-29T10:15:00.000000Z",
    "updated_at": "2026-09-29T10:25:00.000000Z"
  },
  "status": 1
}

Endpoint

POST https://api.partnero.com/v1/payout_requests/{id}/mark_as_paid

Use this after you’ve paid the partner outside Partnero, for example with your own bank transfer. The status becomes finished, the payout’s commissions are marked as paid, and the partner gets the “payout sent” email. The request must be approved first. Allowed statuses are approved, approved_auto_scheduled, failed_auto_scheduled, intermediary_approved_scheduled and mass_approved_scheduled.

Payouts paid through Partnero’s Wise account (intermediary payouts) can’t be marked as paid. They’re settled automatically.

Path parameters

Parameter	Type	Required	Description
`id`	integer	Yes	Payout request ID

No request body is needed.

Request

cURL

curl --location --request POST 'https://api.partnero.com/v1/payout_requests/555/mark_as_paid' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Response

Returns the updated payout request.

{
  "data": {
    "id": 555,
    "partner": "partner_123",
    "status": "finished",
    "amount": 200.0,
    "amount_units": "usd",
    "payout_gateway": "paypal",
    "created_by": "api",
    "created_at": "2026-09-29T10:15:00.000000Z",
    "updated_at": "2026-09-29T10:25:00.000000Z"
  },
  "status": 1
}

See the payout request object for the response fields.

Error responses

Status	Error	Solution
404	Payout request not found	Check the `id` is correct for this program
422	Payout request with status “requested” cannot be marked as paid	Approve the request first
422	Payout that belongs to intermediary payout cannot be marked as paid manually	Intermediary payouts are settled automatically

Mark payout request as paid

curl --request POST \
  --url https://api.example.com/v1/payout_requests/{id}/mark_as_paid

const options = {method: 'POST'};

fetch('https://api.example.com/v1/payout_requests/{id}/mark_as_paid', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/payout_requests/{id}/mark_as_paid",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/payout_requests/{id}/mark_as_paid"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/payout_requests/{id}/mark_as_paid")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": 555,
    "partner": "partner_123",
    "status": "finished",
    "amount": 200.0,
    "amount_units": "usd",
    "payout_gateway": "paypal",
    "created_by": "api",
    "created_at": "2026-09-29T10:15:00.000000Z",
    "updated_at": "2026-09-29T10:25:00.000000Z"
  },
  "status": 1
}

Overview

Program

Partners

Customers

Transactions

Payout requests

Leads

Referral links

Coupons

Promotion codes

Webhooks

Refer-a-friend

Newsletter referral

Mark payout request as paid

Endpoint

Path parameters

Request

Response

Error responses

​Endpoint

​Path parameters

​Request

​Response

​Error responses

Endpoint

Path parameters

Request

Response

Error responses