Get Single Authorization

curl --request GET \
  --url https://api.payaza.africa/live/card/auth_capture/authorize/{authorization_reference} \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.payaza.africa/live/card/auth_capture/authorize/{authorization_reference}"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.payaza.africa/live/card/auth_capture/authorize/{authorization_reference}', 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.payaza.africa/live/card/auth_capture/authorize/{authorization_reference}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$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.payaza.africa/live/card/auth_capture/authorize/{authorization_reference}"

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

	req.Header.Add("Authorization", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.payaza.africa/live/card/auth_capture/authorize/{authorization_reference}")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.payaza.africa/live/card/auth_capture/authorize/{authorization_reference}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

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

{
  "authorization_reference": "AUTH-1234567890",
  "status": "AUTHORIZED",
  "authorization_amount": 100,
  "captured_amount": 0,
  "remaining_amount": 100,
  "currency": "NGN",
  "authorization_code": "123456",
  "expires_at": "2025-01-19T10:30:00",
  "created_at": "2025-01-12T10:30:00",
  "updated_at": "2025-01-12T10:30:00",
  "captured_at": null,
  "voided_at": null,
  "card_last_4": "2346",
  "card_brand": "MASTERCARD",
  "order_reference": "ORD-001",
  "merchant_reference": "MR-001",
  "customer_email": "customer@example.com",
  "customer_name": "John Doe",
  "error_reason": null,
  "void_reason": null
}

Auth-Capture-Void

Get Single Authorization

This endpoint retrieves details of a single authorization by its authorization_reference.

Notes:

authorization_reference:: Must exist and belong to the requesting merchant.

Merchant Ownership: Strictly enforced - only the business that created the authorization can retrieve it. Attempting to access another business’s authorization returns 403 Forbidden.

Authentication: Valid Authorization header required (same format as authorize endpoint).

Security: The system verifies business ownership by comparing the authenticated business.

GET

card

auth_capture

authorize

{authorization_reference}

Get Single Authorization

curl --request GET \
  --url https://api.payaza.africa/live/card/auth_capture/authorize/{authorization_reference} \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.payaza.africa/live/card/auth_capture/authorize/{authorization_reference}"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.payaza.africa/live/card/auth_capture/authorize/{authorization_reference}', 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.payaza.africa/live/card/auth_capture/authorize/{authorization_reference}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$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.payaza.africa/live/card/auth_capture/authorize/{authorization_reference}"

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

	req.Header.Add("Authorization", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.payaza.africa/live/card/auth_capture/authorize/{authorization_reference}")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.payaza.africa/live/card/auth_capture/authorize/{authorization_reference}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

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

{
  "authorization_reference": "AUTH-1234567890",
  "status": "AUTHORIZED",
  "authorization_amount": 100,
  "captured_amount": 0,
  "remaining_amount": 100,
  "currency": "NGN",
  "authorization_code": "123456",
  "expires_at": "2025-01-19T10:30:00",
  "created_at": "2025-01-12T10:30:00",
  "updated_at": "2025-01-12T10:30:00",
  "captured_at": null,
  "voided_at": null,
  "card_last_4": "2346",
  "card_brand": "MASTERCARD",
  "order_reference": "ORD-001",
  "merchant_reference": "MR-001",
  "customer_email": "customer@example.com",
  "customer_name": "John Doe",
  "error_reason": null,
  "void_reason": null
}

Authorizations

Authorization

string

header

required

Payaza {{Public API Key in Base 64}}

Path Parameters

authorization_reference

string

required

The authorization reference from the Authorize response

Response

Payment successful

status

string

Current status of the authorization (e.g., AUTHORIZED, ERROR).

Example:

"AUTHORIZED"

message

string

Descriptive message about the status.

Example:

"Authorization successful"

authorization_reference

string | null

Unique reference for the authorization.

Example:

"AUTH-1234567890"

authorization_amount

number | null

Total amount originally authorized.

Example:

100

captured_amount

number | null

Amount that has been captured so far.

Example:

0

remaining_amount

number | null

Amount remaining available to capture.

Example:

100

currency

string | null

Currency code.

Example:

"NGN"

authorization_code

string | null

Issuer's authorization code.

Example:

"123456"

expires_at

string<date-time> | null

Timestamp when the authorization expires.

Example:

"2025-01-19T10:30:00"

created_at

string<date-time> | null

Timestamp when the authorization was created.

Example:

"2025-01-12T10:30:00"

updated_at

string<date-time> | null

Timestamp of the last update.

Example:

"2025-01-12T10:30:00"

captured_at

string<date-time> | null

Timestamp when the capture occurred.

Example:

null

voided_at

string<date-time> | null

Timestamp when the void occurred.

Example:

null

card_last_4

string | null

Last 4 digits of the card used.

Example:

"2346"

card_brand

string | null

Brand of the card (e.g., MASTERCARD).

Example:

"MASTERCARD"

order_reference

string | null

Order ID associated with the transaction.

Example:

"ORD-001"

merchant_reference

string | null

Merchant's internal reference.

Example:

"MR-001"

customer_email

string<email> | null

Customer's email.

Example:

"customer@example.com"

customer_name

string | null

Customer's full name.

Example:

"John Doe"

error_reason

string | null

Reason for error if applicable.

Example:

null

void_reason

string | null

Reason for void if applicable.

Example:

null

Void Transaction Get All Authorizations

Transfers

Payaza Account

Sub Accounts

EUR Accounts

Apple Pay and Google Pay

Virtual Accounts

Card Collection

Refunds And Chargebacks

Branches

Auth-Capture-Void

Momo And ZAR Collections

Check Transaction Status(Merchant Reference)

Subscription Plans

Subscriptions

Subscription Charge

Subscription Lifecycle

Subscription Reads

Subscription Invoices

Split Settlements

Get Single Authorization

Authorizations

Path Parameters

Response