Introduction

API tester

Welcome to the API tester section of MakeCommerce developer portal. Here you can try out our REST API very easily. We have a small tutorial on how to use our API tester, head out to the API Docs section to find out more.

Basic flow

  1. The buyer has reached to the check-out page on e-shop site
  2. The shop presents the selection of payment methods available
  3. The buyer makes a choice and proceeds to payment
  4. The shop registers a new Transaction in MK-API and directs user to the selected payment channel – either redirects to bank-link or launches the Credit Card Dialog
  5. Shop server now creates the transaction in MK API and recieves back an array of urls pointing to payment channels
  6. Depending on method the user selected, the e-shop server:
    1. Case banklink: redirects user to the banklink url supplied by the transaction creation response
    2. Case credit card: launches MK Credit Card Dialog by invoking checkout.js
  7. Payment links should not be placed inside an iframe, otherwise payments will not work.
  8. The user performs the payment in the channel
  9. Returning from:
    1. Bank link: user is redirected to return_url of the shop with payment_return message
    2. Credit card dialog: user is redirected back with token_return message (POST to return_url)
  10. Payment links should not be placed inside an iframe, otherwise payments will not work.
  11. The shop will verify the message and state of transaction within and display successful payment confirmation page (or goes back to payment method selection step)
  12. MK servers will send additional async message about the transaction status change to the shop server’ notification_url (see notifications))

See also the Payment Gateway aka 'redirect method' that is even more simple way for integration.

There is also a small PHP SDK for API communication available in GitHub.
And as a new addition, there is also a Java SDK available in GitHub.