Online shop

API methods

Authorization

Every API request requires authorization. To process the request, you must generate an authorization header that contains:

• https://stage-backend.revoplus.pl/ – the base URL of the service (test);
• store_id – the unique identifier of the store received from Mokka;
• signature – digital signature generated from JSON request text and secret_key.

Procedure for generating a digital signature

1. Prepare a valid JSON request;
2. Transform the request text by adding an extra "\" before each " and "\" character;
3. Add the secret key received from Mokka to the result;
4. Apply the SHA1 encryption algorithm to the last line.
5. The result is a 40-character digital signature to be added to the request header.

Example of creating a digital signature on ruby

1. The content of the JSON request is written into the variable data :
   1. data = "{"order_id": \"FACTPRECHR152632\", \"amount\": \"8300.00\"}"
2. The variable secret_key contains the name of the key:
   1. secret_key = "9fff8c602b08b00323567be0001480f6"
3. The signature is formed into a signature variable:
   1. signature = Digest::SHA1.hexdigest(data + secret_key)
   2. signature = "347e8cff27d30b5200c8b32def4365ebbf4270d0"

Once the signature has been generated correctly, you can send the request to our system by adding it to the request header.

Here is a sample query:

1. In the request URL field, enter a header with your digital signature and the store ID you received.
   

   • POST https://stage-backend.revoplus.pl/ {API URL}?store_id=01&signature=34738cff27d30b5200c8b32def4365ebbf4270d0

2. In the Body section, enter the text of the callback received in the earlier step, after running the puts command.

   • {
           "callback_url": "https://shop.ro/revo/decision",
           "redirect_url": "https://shop.ro/revo/redirect",
           "primary_phone": "9267654321",
           "primary_email": "LOGIN@MAIL.com",
           "current_order":
           {
               "order_id": "R001234"
           }
       }

Test

Now that you have established proper communication with Mokka API, you can test our Environment. The test scenario below gives you an in-depth look at the purchasing process. API testing procedure

1. Obtaining a customer limit using the Register method;
2. Making a purchase using the Checkout method;
3. Cancelling a completed order using the Cancel method;
4. Return an order using the Return method.

When sending test requests, it is recommended to pass parameters that meet the following conditions:

• Phone number – must start with a 333 prefix, so text messages are not sent to real people
• The confirmation code and pin code is 1111 (the code for testing on the production Server is set in the partner settings).

Additional Documentation with sample requests is in https://docs.mokka.pl/ The scenarios for each stage are described below.

Obtaining the Limit – Registration

Cancellation of an order

Return of an order

If the details of an existing user are entered, the current limit of that user should appear. Special clients number for testing:

• 333 XXX 610 – Rejection of application (blocked client)
• 333 XXX 630 – Rejection of application (client limit it’s not enough)
• 333 XXX 681 – Rejection of application (overdue client)
• 333 XXX XXX – Acceptance of application

Possible error codes

Marketing Materials

Place the item "Mokka - payment in advance" among the payment methods. Buyers have the option to receive a loan from Mokka and pay immediately.

Marketing Materials can you see on:

• Romania version demo.mokka.ro
• Polish version demo.mokka.pl
• Bulgarian version demo.mokka.bg

After pressing: Send Request Order after selecting payment from Mokka

2. Place a banner on the home page opening a form through which the customer can register and find out the amount of advance available to him without leaving the store.

When pressed: Sends a registration request when the banner is clicked.

3. Customize the display of the broken price on the tab of each product. The broken price will show the customer the amount of monthly payment when they purchase the item using the down payment.

After hitting the mokka banner: Send a registration request to Mokka

4. Place the Mokka payment system logo in the footer of your site (bottom of pages).

5. Add a Mokka landing page. On the landing page, the customer can read the detailed terms and conditions, register and find out the amount of down payment available to them, as well as get answers to frequently asked questions. The content of the landing page is provided in the form of an iframe.

After clicking: Opens the Mokka page after clicking on an element.

6. Add information about the possibility to use Mokka in the "Delivery & payment" section (or similar).
7. In addition, partner's employees who work with customers should read the Mokka Terms of Service listed at:
   • https://pomoc.mokka.pl/hc/pl/
   • https://asistenta.mokka.ro/hc/ro/
   • https://help.mokka.bg/hc/bg

Launch

After successfully completing all the previous integration steps, you are ready to receive payments using Avansa Mokka. To start accepting payments, you need to contact the Mokka integration manager to transfer your online store to combat mode and receive commercial settings from it, such as store_id and secret_key battle keys, as well as the base URL of the server for sending combat requests.

By replacing the test settings with commercial ones, you provide customers with access to the Mocha advance, which will significantly increase the number of sales of your online store and reduce the number of carts abandoned at the checkout stage.