Payaza Documentation

Introduction

POSThttps://api.payaza.africa/live/payout-receptor/payout

Note

Supported Currencies and Options

We currently support payouts to: Nigeria(NGN), Ghana (GHS), Tanzania(TZS), Uganda(UGX), Kenya(KES)

Bank Transfers	Mobile Money

Arguments

Authorization Header Values

POST

          
{ 
  "authorization": Payaza UFo3OC1QS0xJVkUtRjMwODcwNUMtRkY2NC00MEJCLTg1OUUtM0ZCQUI4MTJBNzdC
  "x-TenantID": test
}

Initiate A Transfer

POST

          
import http.client
import json

conn = http.client.HTTPSConnection("api.payaza.africa")
payload = json.dumps({
  "transaction_type": "nuban",
  "service_payload": {
    "payout_amount": 100,
    "transaction_pin": 1111,
    "account_reference": "1010000009",
    "currency": "NGN",
    "payout_beneficiaries": [
      {
        "credit_amount": 100,
        "account_number": "9207067319",
        "account_name": "John Doe",
        "bank_code": "000013",
        "narration": "Test",
        "transaction_reference": "TD93001234",
        "sender": {
          "sender_name": "Jane Doe",
          "sender_id": "",
          "sender_phone_number": "01234595",
          "sender_address": "123, Ace Street"
        }
      }
    ]
  }
})
headers = {
  'Authorization': 'Payaza UFo3OC1QS0xJVkUtQkNDRUIwMEMtODdBNC00RjJBLUEyNUItND',
  'X-TenantID': 'test',
  'Content-Type': 'application/json'
}
conn.request("POST", "/live/payout-receptor/payout", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

RESPONSE

{
  "response_code": 200,
  "response_message": "Request successfully submitted",
  "response_content": {
    "transaction_status": "09",
    "narration": "Payout",
    "transaction_time": "2023-10-19T14:37:35.517809",
    "amount": 100,
    "response_status": "TRANSACTION_INITIATED",
    "response_description": "Transaction has been successfully submitted for processing"
  },
  "resp_code": "09"
}