HomeGuidesAPI Reference
API Reference

Merchant Registation

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Overview

Register a new merchant onboarding request.

This API is used to submit merchant details and required documents for onboarding.


Endpoint

POST https://demo-api.edfapay.com/public/signup


Request Body

FieldTypeRequiredDescription
fullNameStringYesMerchant full name
companyNameStringYesCompany name
addressStringYesAddress
companyWebsiteStringNoWebsite
emailStringYesEmail
mobileNumberStringYesPhone
ibanNumberStringYesIBAN
nationalIdStringYesNational ID
isFreeLanceBooleanYesFreelancer flag
userTypeStringYesUser type
merchantOnboardDocumentsRequestsArrayYesDocuments list

Request Example

curl --location '{{base_url}}/public/signup' \
--header 'Content-Type: application/json' \
--data '{
  "fullName": "Test User",
  "companyName": "Test Company",
  "address": "Riyadh",
  "companyWebsite": "https://example.com",
  "email": "[email protected]",
  "ibanNumber": "SA0000000000000000000000",
  "mobileNumber": "+966-500000000",
  "nationalId": "1234567890",
  "isFreeLance": true,
  "userType": "FreeLance",
  "merchantOnboardDocumentsRequests": [
    {
      "name": "CR_CERTIFICATE_doc",
      "type": "CR_CERTIFICATE",
      "data": {
        "fileSize": 12345,
        "fileName": "cr.pdf",
        "contentType": "application/pdf",
        "base64": "BASE64_DATA"
      }
    }
  ]
}'

Response Body

FieldTypeDescription
codeIntegerStatus
messageStringResponse message
dataObjectOnboarding data

Response Example

{
    "code": 200,
    "message": "Success",
    "errorCode": null,
    "data": "Successfully created"
}

📘

Note

Documents must be sent as Base64 encoded files

Body Params
Headers
string
Response

Language
Credentials
Bearer
LoadingLoading…