Cancel
curl --request POST \
--url https://seerbitapi.com/api/v2/payments/cancel \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"paymentReference": "PREAUTH124456789798765k3L1CB0",
"publicKey": "SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu",
"country": "NG",
"productDescription": "test void"
}
'import requests
url = "https://seerbitapi.com/api/v2/payments/cancel"
payload = {
"paymentReference": "PREAUTH124456789798765k3L1CB0",
"publicKey": "SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu",
"country": "NG",
"productDescription": "test void"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
paymentReference: 'PREAUTH124456789798765k3L1CB0',
publicKey: 'SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu',
country: 'NG',
productDescription: 'test void'
})
};
fetch('https://seerbitapi.com/api/v2/payments/cancel', 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://seerbitapi.com/api/v2/payments/cancel",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'paymentReference' => 'PREAUTH124456789798765k3L1CB0',
'publicKey' => 'SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu',
'country' => 'NG',
'productDescription' => 'test void'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"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 := "https://seerbitapi.com/api/v2/payments/cancel"
payload := strings.NewReader("{\n \"paymentReference\": \"PREAUTH124456789798765k3L1CB0\",\n \"publicKey\": \"SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu\",\n \"country\": \"NG\",\n \"productDescription\": \"test void\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
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.post("https://seerbitapi.com/api/v2/payments/cancel")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"paymentReference\": \"PREAUTH124456789798765k3L1CB0\",\n \"publicKey\": \"SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu\",\n \"country\": \"NG\",\n \"productDescription\": \"test void\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://seerbitapi.com/api/v2/payments/cancel")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"paymentReference\": \"PREAUTH124456789798765k3L1CB0\",\n \"publicKey\": \"SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu\",\n \"country\": \"NG\",\n \"productDescription\": \"test void\"\n}"
response = http.request(request)
puts response.read_body{
"status": "SUCCESS",
"data": {
"code": "00",
"payments": {
"paymentReference": "PREAUTH1244567890987654321CB0",
"status": "CANCELLED",
"card": {
"bin": "512345",
"last4": "0008"
}
},
"message": "APPROVED"
}
}PREAUTHORIZATION
Cancel
Cancel a payment if supported by the payment method.
POST
/
payments
/
cancel
Cancel
curl --request POST \
--url https://seerbitapi.com/api/v2/payments/cancel \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"paymentReference": "PREAUTH124456789798765k3L1CB0",
"publicKey": "SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu",
"country": "NG",
"productDescription": "test void"
}
'import requests
url = "https://seerbitapi.com/api/v2/payments/cancel"
payload = {
"paymentReference": "PREAUTH124456789798765k3L1CB0",
"publicKey": "SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu",
"country": "NG",
"productDescription": "test void"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
paymentReference: 'PREAUTH124456789798765k3L1CB0',
publicKey: 'SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu',
country: 'NG',
productDescription: 'test void'
})
};
fetch('https://seerbitapi.com/api/v2/payments/cancel', 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://seerbitapi.com/api/v2/payments/cancel",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'paymentReference' => 'PREAUTH124456789798765k3L1CB0',
'publicKey' => 'SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu',
'country' => 'NG',
'productDescription' => 'test void'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"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 := "https://seerbitapi.com/api/v2/payments/cancel"
payload := strings.NewReader("{\n \"paymentReference\": \"PREAUTH124456789798765k3L1CB0\",\n \"publicKey\": \"SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu\",\n \"country\": \"NG\",\n \"productDescription\": \"test void\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
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.post("https://seerbitapi.com/api/v2/payments/cancel")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"paymentReference\": \"PREAUTH124456789798765k3L1CB0\",\n \"publicKey\": \"SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu\",\n \"country\": \"NG\",\n \"productDescription\": \"test void\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://seerbitapi.com/api/v2/payments/cancel")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"paymentReference\": \"PREAUTH124456789798765k3L1CB0\",\n \"publicKey\": \"SBTESTPUBK_dhrpzbRpR34l6VmqkCFOKA94L5E1jSTu\",\n \"country\": \"NG\",\n \"productDescription\": \"test void\"\n}"
response = http.request(request)
puts response.read_body{
"status": "SUCCESS",
"data": {
"code": "00",
"payments": {
"paymentReference": "PREAUTH1244567890987654321CB0",
"status": "CANCELLED",
"card": {
"bin": "512345",
"last4": "0008"
}
},
"message": "APPROVED"
}
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
application/json
This is the unique identifier for a transaction, to be generated by merchant.
This is the merchant public key.
This is the country the customer is doing the transaction from
This is the product description supplied by the merchant.
Response
The response is of type CancelResponse · object.