Buyer confirm payment (standard)
curl --request POST \
--url https://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId} \
--header 'Authorization: Bearer <token>' \
--header 'customer-id: <customer-id>'import requests
url = "https://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId}"
headers = {
"customer-id": "<customer-id>",
"Authorization": "Bearer <token>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'customer-id': '<customer-id>', Authorization: 'Bearer <token>'}
};
fetch('https://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId}', 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://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"customer-id: <customer-id>"
],
]);
$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://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId}"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("customer-id", "<customer-id>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId}")
.header("customer-id", "<customer-id>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["customer-id"] = '<customer-id>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": 200,
"message": "Escrow updated successfully",
"data": {
"id": "6a3cdafc734e96016b227367",
"amount": 1000,
"purpose": "multi-purpose escrow item",
"description": "details",
"whoPays": "buyer",
"imageUrl": null,
"fee": 30,
"paymentToken": "PY_TIrNY1CD3836",
"sellerId": "6a19b57ffa797d3af379ca2a",
"buyerId": "69fe44bbc2cd478224ced16f",
"paidAt": "1782373118",
"status": "COMPLETED",
"state": "CLOSED",
"logs": [],
"channel": "API",
"isSeller": false,
"dispute": null,
"category": null,
"completedAt": "1782378109",
"approvedClaimBy": null,
"refundedBy": null,
"paymentId": "6a3cdafd734e96016b22736b",
"maxDelivery": 1,
"deliveryDetails": null,
"deliveryTimeline": "hours",
"totalQuantity": 1,
"settlementType": "STANDARD",
"milestones": [],
"createdAt": "2026-06-25T07:38:37.283Z",
"updatedAt": "2026-06-25T09:01:49.197Z",
"environment": "live",
"isMerchant": true,
"merchantId": null
}
}{
"status": 400,
"message": "Action not allowed",
"data": {}
}{
"status": 401,
"message": "Access denied",
"data": {}
}{
"status": 429,
"message": "Too many request"
}7. Release & resolve: Disputes
Buyer confirm payment (standard)
Buyer confirms delivery on a standard escrow; releases the full amount to the seller and completes the escrow. Requires the customer-id header (the buyer).
POST
/
v1
/
escrow
/
confirm-payment
/
{escrowId}
Buyer confirm payment (standard)
curl --request POST \
--url https://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId} \
--header 'Authorization: Bearer <token>' \
--header 'customer-id: <customer-id>'import requests
url = "https://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId}"
headers = {
"customer-id": "<customer-id>",
"Authorization": "Bearer <token>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'customer-id': '<customer-id>', Authorization: 'Bearer <token>'}
};
fetch('https://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId}', 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://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"customer-id: <customer-id>"
],
]);
$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://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId}"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("customer-id", "<customer-id>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId}")
.header("customer-id", "<customer-id>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://staging.api.payluk.ng/v1/escrow/confirm-payment/{escrowId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["customer-id"] = '<customer-id>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": 200,
"message": "Escrow updated successfully",
"data": {
"id": "6a3cdafc734e96016b227367",
"amount": 1000,
"purpose": "multi-purpose escrow item",
"description": "details",
"whoPays": "buyer",
"imageUrl": null,
"fee": 30,
"paymentToken": "PY_TIrNY1CD3836",
"sellerId": "6a19b57ffa797d3af379ca2a",
"buyerId": "69fe44bbc2cd478224ced16f",
"paidAt": "1782373118",
"status": "COMPLETED",
"state": "CLOSED",
"logs": [],
"channel": "API",
"isSeller": false,
"dispute": null,
"category": null,
"completedAt": "1782378109",
"approvedClaimBy": null,
"refundedBy": null,
"paymentId": "6a3cdafd734e96016b22736b",
"maxDelivery": 1,
"deliveryDetails": null,
"deliveryTimeline": "hours",
"totalQuantity": 1,
"settlementType": "STANDARD",
"milestones": [],
"createdAt": "2026-06-25T07:38:37.283Z",
"updatedAt": "2026-06-25T09:01:49.197Z",
"environment": "live",
"isMerchant": true,
"merchantId": null
}
}{
"status": 400,
"message": "Action not allowed",
"data": {}
}{
"status": 401,
"message": "Access denied",
"data": {}
}{
"status": 429,
"message": "Too many request"
}Authorizations
Your secret key as a Bearer token. The key prefix selects the environment: sk_test_... (staging) or sk_live_... (production); a key on the wrong host is refused with 403 Unauthorized Access. Each key is limited to 10 requests per minute (429 beyond that) and, on production, to the IP addresses on your dashboard allowlist when one is configured.
Headers
The merchant customer this request acts on behalf of.
Path Parameters
The escrow's unique identifier.