Create Order by Generating a QR code

get https://api.staging.madfu.com.sa/Merchants/CreateQR

This API endpoint represents the first type of integration with MADFU. It allows merchants to create a new order and generate a QR code for seamless online payments via the MADFU app. Upon receiving a request, the API creates a new order with the provided details and generates a unique QR code associated with the order. Customers can then scan this QR code using the MADFU app on their mobile devices to initiate the payment process directly from their preferred payment method. The generated QR code contains essential information about the order, including the total invoice amount, ensuring accurate payment processing.

Query Params

merchantName

string

The merchant name that will appear during the payment process and will be included in the generated QR code.

vatRegistration

number

Please input your VAT registration number. You can locate it within the login response body under the following path: responseBody.merchantData.vatRegistration.

invoiceAmount

double

required

Specifies the total amount of the invoice for the order. This parameter represents the total monetary value that the customer is expected to pay for the order.

Headers

Token

string

required

JWT Token that generated from /merchants/token/sign-in API without 'Bearer ' keyword.

APIKey

string

required

Your API Key. This key is required for authentication and authorization purposes.

AppCode

string

required

Your App Code. This code identifies your application to the server.

PlatformTypeId

string

required

Platform TypeId. This ID indicates the type of platform you are using.

Authorization

string

required

Authorization. This token grants access to protected resources.

Responses

200While the 200 OK HTTP status code is common, it doesn't solely indicate success in this API. Clients must check the 'statusCode' property in the response body to confirm the operation's success or failure accurately.

401 indicates that the request has not been applied because it lacks valid authentication credentials for the target resource.

500This indicates unexpected server errors or, at times, errors resulting from invalid user inputs.