Request Corporate and User Subaccount

curl --request POST \
  --url https://api.payaza.africa/live/payaza-account/api/v1/subaccounts/merchant/euro/request \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'X-TenantID: <api-key>' \
  --data '
{
  "country": "NG",
  "purpose": "test purposes",
  "currency": "EUR",
  "category": "SUB_ACCOUNT",
  "certificate_of_incorporation": "https://payaza-assets.s3.amazonaws.com/development/1737370134640-number2.png",
  "mermat": "https://payaza-assets.s3.amazonaws.com/development/1737370128708-number1.jpg",
  "consent": true,
  "account_type": "corporate",
  "main_account_payaza_reference": "10987654312",
  "company_name": "Steve Stones Plc",
  "directors": [
    {
      "id_file": "https://payaza-assets.s3.amazonaws.com/development/1737370156723-number3.jpg",
      "id_type": "passport",
      "poa_file": "https://payaza-assets.s3.amazonaws.com/development/1737370165810-number4.jpg",
      "poa_type": "utilityBill"
    },
    {
      "id_file": "https://payaza-assets.s3.amazonaws.com/development/1737370156723-number3.jpg",
      "id_type": "passport",
      "poa_file": "https://payaza-assets.s3.amazonaws.com/development/1737370165810-number4.jpg",
      "poa_type": "utilityBill"
    }
  ],
  "shareholders": [
    {
      "id_file": "https://payaza-assets.s3.amazonaws.com/development/1737370178824-number5.jpg",
      "id_type": "passport",
      "poa_file": "https://payaza-assets.s3.amazonaws.com/development/1737370187160-number6.png",
      "poa_type": "utilityBill"
    },
    {
      "id_file": "https://payaza-assets.s3.amazonaws.com/development/1737370178824-number5.jpg",
      "id_type": "passport",
      "poa_file": "https://payaza-assets.s3.amazonaws.com/development/1737370187160-number6.png",
      "poa_type": "utilityBill"
    },
    {
      "id_file": "https://payaza-assets.s3.amazonaws.com/development/1737370178824-number5.jpg",
      "id_type": "passport",
      "poa_file": "https://payaza-assets.s3.amazonaws.com/development/1737370187160-number6.png",
      "poa_type": "utilityBill"
    }
  ]
}
'

{
  "message": "EUR Account request has been submitted for review.",
  "status": true,
  "creationReference": "ac456ecb-7870-47d4-af23-2dde8563235f"
}

POST

payaza-account

api

subaccounts

merchant

euro

request

curl --request POST \
  --url https://api.payaza.africa/live/payaza-account/api/v1/subaccounts/merchant/euro/request \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'X-TenantID: <api-key>' \
  --data '
{
  "country": "NG",
  "purpose": "test purposes",
  "currency": "EUR",
  "category": "SUB_ACCOUNT",
  "certificate_of_incorporation": "https://payaza-assets.s3.amazonaws.com/development/1737370134640-number2.png",
  "mermat": "https://payaza-assets.s3.amazonaws.com/development/1737370128708-number1.jpg",
  "consent": true,
  "account_type": "corporate",
  "main_account_payaza_reference": "10987654312",
  "company_name": "Steve Stones Plc",
  "directors": [
    {
      "id_file": "https://payaza-assets.s3.amazonaws.com/development/1737370156723-number3.jpg",
      "id_type": "passport",
      "poa_file": "https://payaza-assets.s3.amazonaws.com/development/1737370165810-number4.jpg",
      "poa_type": "utilityBill"
    },
    {
      "id_file": "https://payaza-assets.s3.amazonaws.com/development/1737370156723-number3.jpg",
      "id_type": "passport",
      "poa_file": "https://payaza-assets.s3.amazonaws.com/development/1737370165810-number4.jpg",
      "poa_type": "utilityBill"
    }
  ],
  "shareholders": [
    {
      "id_file": "https://payaza-assets.s3.amazonaws.com/development/1737370178824-number5.jpg",
      "id_type": "passport",
      "poa_file": "https://payaza-assets.s3.amazonaws.com/development/1737370187160-number6.png",
      "poa_type": "utilityBill"
    },
    {
      "id_file": "https://payaza-assets.s3.amazonaws.com/development/1737370178824-number5.jpg",
      "id_type": "passport",
      "poa_file": "https://payaza-assets.s3.amazonaws.com/development/1737370187160-number6.png",
      "poa_type": "utilityBill"
    },
    {
      "id_file": "https://payaza-assets.s3.amazonaws.com/development/1737370178824-number5.jpg",
      "id_type": "passport",
      "poa_file": "https://payaza-assets.s3.amazonaws.com/development/1737370187160-number6.png",
      "poa_type": "utilityBill"
    }
  ]
}
'

{
  "message": "EUR Account request has been submitted for review.",
  "status": true,
  "creationReference": "ac456ecb-7870-47d4-af23-2dde8563235f"
}

Authorizations

Authorization

string

header

required

Payaza {{Public API Key in Base 64}}

X-TenantID

string

header

required

live or test

Body

application/json

Request Corporate Subaccount
Request User Sub-account Request

country

string

required

The 2-letter ISO country code (e.g.US.)

Example:

"US"

purpose

string

required

The purpose for opening the account.

Example:

"test purposes"

currency

string

required

The currency code e.g. EUR.

Example:

"EUR"

Response

Sub-account requested

message

string

Response message.

Example:

"EUR Account request has been submitted for review."

status

boolean

Request status.

Example:

true

creationReference

string

Unique reference ID to track the status of the review.

Example:

"ac456ecb-7870-47d4-af23-2dde8563235f"

View Payaza Sub Account Details Get All EUR Account Request

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

Request Corporate and User Subaccount

Authorizations

Body

Response