Create order with meta data

This endpoint helps KYC merchant tag each order when using the system as a multimerchant system. Tagging each order allows to separate user data across different merchants.

POST https://fuspay-kyc-prod-e9eb4fd3aa33.herokuapp.com/api/v1/order/meta-data

Name	Type	Description
full_name	string	full name of the user.
email	string	email of the user.
phone	string	phone number of the user.
kyc_type	string	the kyc type e.g individual.
callback	string	the webhook callback.
redirect	string	the url you are redirecting to.
reference	string	the user reference id.
meta_data	object	An object containing the metadata tag. The metadata tag contains the tag of the merchant attached to the data. Used to identify the order
app	"string"	This is a tag to identify

Request Body sample

{
    "full_name": "Timilehin Abodunrin",
    "email": "[email protected]",
    "phone": "2348113372866",
    "app": "675823c1200bbd9e32e2f2ca",
    "kyc_type": "Individual",
    "callback": "https://webhook.site/aa339fc2-ea12-4ad4-96b8-d88a5742310c",
    "redirect": "https://custom-webhook-app-8b6d54acde1c.herokuapp.com", 
    "reference": "intrapay_ref_1234",
    "meta_data": {
        "merchant_tag": "KYC App"
    }
}

Response Body

200: Ok

{
    "user_facial_images": {
        "image_1": "",
        "image_2": ""
    },
    "_id": "68ed03019dae9ae0e57d30a4",
    "email": "[email protected]",
    "full_name": "Timilehin Abodunrin",
    "phone": "2348113371266",
    "kyc_type": {
        "_id": "667aba4d4f0d680f9ce45163",
        "name": "Individual",
        "created_at": "2024-06-25T12:38:37.482Z",
        "updated_at": "2024-06-25T12:38:37.482Z",
        "__v": 0
    },
    "scan_ref": "",
    "verification_url": "https://kyc.fuspay.finance/verification/individual/68ed03019dae9ae0e57d30a6",
    "callback": "https://webhook.site/3b6bbe09-cd27-4b66-8bcc-393fadfcc35",
    "reference": "09192283884474",
    "redirect": "https://custom-webhook-app-8b6d54acde1c.herokuapp.com",
    "address": "",
    "bvn": "",
    "country": "",
    "govt_id_no": "",
    "govt_id_photo": "",
    "proof_of_address": "",
    "bank_statement": "",
    "user_indemnity": "",
    "guarantors_form": "",
    "id_of_guarantor": "",
    "guarantors_proof_of_address": "",
    "status": "Active",
    "face_image": "",
    "postal_code": "",
    "document_image": "",
    "dob": "",
    "kyc_verification_status": "init",
    "created_at": "2025-10-13T13:47:45.410Z",
    "updated_at": "2025-10-13T13:47:45.410Z",
    "__v": 0
}