👩‍💻Profile

Contact [email protected] to get instructions on how to register a profile on DigiMali. Once registered you will be provided access credentials that you can use to access the API.

Fetch Profile

Call this endpoint to view the profile information of an account, supply the username and password.

post

This endpoint retrieves profile information for an authenticated user. The request requires an API token in the header and user credentials in the request body.

Header parameters

AuthorizationstringRequired

Secret Token for user authentication

Example: {"value":"Token tk-abcdef-uhhgggggf-yygfff"}

Body

application/json

emailstring · emailOptional

User's registered email address

Example: [email protected]

passwordstring · passwordOptional

User's password for authentication

Example: StrongPassword123!

Responses

200

User profile retrieved successfully

application/json

additional_contactsstring[]OptionalExample: []

address_jsonobjectOptionalExample: {}

emailstringOptionalExample: [email protected]

first_namestringOptionalExample: Test Merchant

last_namestringOptional

merchant_urlstringOptional

payment_facilitatorstringOptional

phone_numberstringOptional

400

Invalid email or password

application/json

401

Unauthorized access

application/json

500

Internal server error

application/json

post

/api/v1/fetch-profile

HTTPcURLJavaScriptPython

POST /api/v1/fetch-profile HTTP/1.1
Host: stage-api.digimali.co.za
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "email": "[email protected]",
  "password": "StrongPassword123!"
}

{
  "additional_contacts": [],
  "address_json": {},
  "email": "[email protected]",
  "first_name": "Test Merchant",
  "last_name": "",
  "merchant_url": "",
  "payment_facilitator": "",
  "phone_number": "",
  "tokens": [
    {
      "primary": true,
      "token": "your-token-here"
    }
  ],
  "wallets": [
    {
      "default": true,
      "id": "some-id-string"
    }
  ]
}