Share Order

post https://api.staging.madfu.com.sa/Merchants/Order/shareOrder

The Share Order with Customer feature allows MADFU partners to remotely share orders with MADFU customers. Customers are notified and directed to choose their desired MADFU payment option and complete the order smoothly, without any integration required from the partner's side.

Body Params

mobileNumber

string

required

It's essential for sending order details to the user via SMS or push notification. This represents the user's mobile number where the order will be sent.

amount

double

required

The total amount including taxes. This represents the total cost of the order, including any applicable taxes or fees.

merchantReference

string

Your unuique reference number

BranchExternalReferenceNumber

string

Send this parameter, if you need to assign an order to a specific branch using your branch code. This parameter is only used when accessing the system as a merchant user.

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.