Skip to main content
POST
/
payaza-account
/
api
/
v1
/
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
​
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"

​
category
string
required

The category of the account.

Example:

"SUB_ACCOUNT"

​
certificate_of_incorporation
string<uri>
required

URL link to the certificate of incorporation.

Example:

"https://payaza-assets.s3.amazonaws.com/development/cert.png"

​
consent
boolean
required

Whether the company consents to the account request.

Example:

true

​
account_type
string
required

Type of account (corporate).

Example:

"corporate"

​
main_account_payaza_reference
string
required

The main Payaza account reference number.

Example:

"10987654312"

​
company_name
string
required

The registered company name.

Example:

"Steve Stones Plc"

​
directors
object[]
required

List of directors with identification and proof of address.

​
mermat
string<uri>

URL link to company memorandum and articles of association.

Example:

"https://payaza-assets.s3.amazonaws.com/development/mermat.jpg"

​
shareholders
object[]

List of company shareholders (Optional).

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"