Mayar Integration

Connect your Mayar account to Konektor. Konektor saves Mayar payments and payment reminders as orders, then links them to the lead with the same WhatsApp number.

After you connect, Konektor can:

• Create a new lead for a buyer who is not in your list yet.
• Change the lead status: Invoice Sent when the buyer did not pay, Purchase when the payment arrives.
• Run closing flows: payment reminders and thank-you messages from your WhatsApp number.
• Send one Purchase event for each paid order to your ad platforms (optional, off by default).

Konektor uses two Mayar events: payment received and payment reminder. Konektor does not use other events, such as shipping status and membership.

Who this is for

Use this integration if you sell on Mayar and close sales on WhatsApp. You do not change your Mayar checkout pages.

Prerequisites

1. A real Mayar account. Konektor cannot use a Mayar test (sandbox) account.
2. A Mayar API key with Read Only access. You create it in the API Keys menu of the Mayar dashboard.
3. Owner access to the Konektor workspace.
4. For automatic messages: at least one WhatsApp number connected to the Konektor Inbox.

Connect Mayar

The setup has two steps. Open two tabs: Konektor and Mayar.

Step 1: Create the store and check the API key

1. In Mayar, open the API Keys menu. Create a new key with Read Only access, then copy the key.
2. In Konektor, open Settings > Store & orders.
3. Click Connect a store, then choose Mayar.
4. Enter a Store name, for example "Coffee Shop".
5. Paste the key in the Mayar API key field, then click Create address.
6. Konektor saves the store and checks the key with Mayar. If the key is right, the page goes to step 2.

If Mayar refuses the key, the page shows "The API key is not valid. Copy it from Mayar again." Paste the right key in the same field, then click Check. Konektor uses the same store, so you do not create a second store.

If the page shows "Mayar is not reachable now" or "Konektor cannot check the key now", your key is saved. Click Continue. Check the key again later in Settings on the store card.

Step 2: Add the webhook address in Mayar

1. Click Copy next to the webhook address that Konektor shows.
2. In Mayar, open Integration, then Webhook.
3. Paste the address in the Webhook URL field. Keep the Purchase and Reminder event switches on, then save. Konektor does not use the other events, such as membership.
4. Press Test URL in Mayar.
5. Go back to Konektor. The page waits up to 5 minutes for the test, then shows "The test from Mayar arrived."
6. Click Done.

If the test does not arrive in 5 minutes, make sure Mayar saved the address. Then click Check again.

The Mayar test checks only the address. The test does not create an order. Konektor does not change your Mayar settings. You paste the address yourself.

How Konektor handles Mayar events

The store settings decide if Konektor creates leads, changes the lead status, and sends Purchase. See The three store settings.

When the buyer pays

1. Mayar tells Konektor that a payment arrived.
2. Konektor reads the transaction directly from Mayar and checks that it is paid.
3. Konektor saves the order as Paid and links it to the lead with the same WhatsApp number. If the lead does not exist, Konektor creates it.
4. Konektor changes the lead status to Purchase.
5. Flows with the trigger Payment is received run. Payment reminders for that order stop.
6. If Send Purchase to ad platforms is on, Konektor sends one Purchase.

Konektor uses the payment time from Mayar. Flows do not run for a payment that is more than 3 days old, for example when Mayar sends old data again. Konektor still saves the order and the lead.

When the buyer does not pay

Mayar sends a payment reminder about 30 minutes after an unpaid checkout. Konektor checks that transaction with Mayar. There are three results:

• Still not paid: Konektor saves the order as Not paid, with the payment link when Mayar gives one. The lead status changes to Invoice Sent. Flows with the trigger A new order is created run.
• Already paid: Konektor saves the order as paid, like a normal payment. Flows with the trigger A new order is created do not run.
• Payment link expired: Konektor marks the order as cancelled. Flows with the trigger An order is cancelled run.

A buyer who pays within 30 minutes does not cause a reminder. Konektor gets that order when the payment arrives.

Why Konektor needs the API key

Konektor uses this key to read the payment status and the buyer data directly from Mayar. So the order data in Konektor always equals the data in Mayar.

Konektor only reads data. Konektor does not change anything in your Mayar account. Konektor shows only the last 4 characters of the saved key.

The three store settings

Open the store card in Store & orders, then click Settings.

The Purchase value equals the total that the buyer pays. Konektor sends one Purchase for one order, and only for an order that has a lead. If Mayar sends the Meta tracking data of the buyer (fbc and fbp), Konektor uses it so that the Purchase matches your ad better. Konektor uses only data that matches the transaction in Mayar, and keeps the data that arrived first for that order.

The Purchase uses your event mapping for the Closed won status in Conversion Settings. The Leads page calls the same status Purchase. Konektor sends it to every active ad platform.

Closing flows for Mayar orders

A closing flow sends WhatsApp messages, changes the lead status, adds tags, and writes notes when something happens to an order. A flow stops by itself when the buyer pays or replies.

1. Open Conversations > Automation Rules, then choose the Orders tab.
2. Click Create flow, or pick an example in Start from an example.
3. Choose the trigger, set the steps and delays, then click Save flow.

Only the Owner and Admins can create flows. One workspace can have up to 20 flows. The Closing flows list shows all your flows. For all options, see Order flows.

Triggers that Mayar sends

Mayar does not send other triggers, such as A checkout is abandoned and Payment fails. If you choose one of them, the flow editor shows a warning. The flow does not run for Mayar stores.

Examples that fit

• Order confirmation and payment reminder: trigger A new order is created. The first message sends right away, then two reminders send after 1 hour and 1 day. Mayar tells Konektor about 30 minutes after checkout. So keep the delay of the first step at 0.
• Thank you after payment: trigger Payment is received. Konektor sends a thank-you message and adds the tag buyer.

The example Checkout recovery does not fit Mayar.

Message keywords

Write a keyword with two curly brackets. Konektor fills it from the order.

Konektor gets the payment link from Mayar when the reminder arrives. If Mayar does not give a link, an action that uses {{payment_link}} is skipped. A paid order usually has no payment link. Konektor refuses a message that uses another keyword.

Stop rules and quiet hours

Konektor checks three rules before each step. All three are on by default:

• Stop when the buyer has paid.
• Stop when the buyer replies.
• Stop when the order is cancelled.

When Mayar confirms a payment, the reminders for that order stop at once.

A step with a delay waits until quiet hours end. The default is 21:00 to 08:00 in the workspace time zone. A step with no delay does not wait.

Choose the sender WhatsApp number in the Send WhatsApp action. That number must be active in the Konektor Inbox.

Check that it works

1. Create a test transaction in Mayar with a cheap product and your own WhatsApp number.
2. To test a payment, pay the transaction. To test a payment reminder, do not pay and wait about 30 minutes.
3. In Store & orders, click Recent events on the store card. The list shows the event type, the time, and the result. It shows no buyer data.
4. Open Leads and click the lead with that number. The order shows in the Store orders section. The flow results show under the order.

Store states that you can see:

Results that you can see in the event list:

Konektor does not process refunds. If you refund a payment in Mayar, the order in Konektor stays paid.

Common problems

Mayar refused the API key

The store card shows Needs a check and the message "Mayar refused the API key. Create a new key in Mayar and paste it here." The cause: someone deleted or turned off the key in Mayar, or the copy of the key is not complete.

1. In Mayar, open the API Keys menu. Create a new key with Read Only access.
2. In Konektor, open the store card, then click Settings.
3. Paste the new key in the Mayar API key field, then click Check.
4. If the result is valid, the message on the card goes away.

While Mayar refuses the key, events from Mayar show Waiting to retry. After you replace the key, Konektor tries those events again within one hour. Fix the key within 3 days. Konektor stops trying events that are more than 3 days old.

Mayar did not confirm this transaction

Konektor got an event from Mayar, but Mayar does not show a matching transaction, or the transaction is not paid. Konektor changes no data: no order, no lead, no message, and no Purchase.

Konektor checks again for about 2 hours. The event shows Waiting to retry. If Mayar still does not confirm, the event shows Skipped.

• Make sure the API key comes from the same Mayar account that sends the webhook.
• In Mayar, check the transaction and its status. If the buyer pays later, Mayar sends a new event and Konektor processes it.
• If you do not know the transaction, do nothing. If events like this keep coming, click Create new address on the store card, then paste the new address in Mayar.

No orders arrive

1. Make sure the store is Active or Waiting for orders, not Paused. Click Resume if needed.
2. In Mayar, open Integration > Webhook. Make sure the address is the same as the Konektor address. Click Show address to see it.
3. Mayar keeps only one webhook address for each account. If another tool replaced that address, paste the Konektor address again.
4. If you created a new address, paste that new address in Mayar.
5. If the card shows Waiting for orders, click Continue setup. Press Test URL in Mayar, then check if the page shows "The test from Mayar arrived."
6. Remember: Konektor processes only payments and payment reminders. A payment reminder arrives about 30 minutes after an unpaid checkout.

Waiting in line

The event shows "Waiting in line. Konektor processes this soon." The event waits for its turn. Konektor processes it by itself in a few minutes. You do not need to do anything.

The messages "Mayar is busy" and "Konektor cannot reach Mayar now" mean the same: Konektor tries again by itself. If the event still waits after a few hours, open Help > My tickets. Include the store name and the time of the event. Do not attach the API key or the webhook address.

Data from Mayar is piling up

The store card shows Needs a check and the message "Data from Mayar is piling up. Some new data is turned away for now and may not reach Konektor." Too much data from Mayar still waits to be processed. Konektor turns away part of the new data until the waiting data gets smaller. Konektor still processes the data that arrived already.

• Wait a few minutes. The message goes away after Konektor gets new data again.
• A promotion or a product launch can cause this for a short time. Konektor processes the waiting data by itself.
• If you run no promotion or launch and the message stays, click Create new address on the store card, then paste the new address in Mayar.
• If the message keeps coming, open Help > My tickets. Include the store name and the time of the event. Do not attach the API key or the webhook address.

An order arrives, but there is no lead

• Check the Create leads from orders setting. If it is off, an order from a new number does not create a lead.
• The daily lead limit of the workspace can be full. Konektor still saves the order, but closing flows do not run for an order without a lead.
• Konektor cannot match an order without a valid WhatsApp number to a lead.

Messages are not sent

1. Make sure the flow is on and the store is Active.
2. Make sure the sender WhatsApp number is active in the Inbox.
3. For an official number, choose a template if the buyer did not reply in the last 24 hours.
4. Look at the result in the Store orders section of the lead. For example: "The order has no payment link." means Mayar did not give a payment link. "Some order data is empty for this message." means one keyword in the message has no value.

Pause and delete a store

• Pause: click Pause on the store card. Konektor stops accepting events from Mayar for that store. Flows that run for that store stop too. Your settings and old data stay. Konektor does not process events that Mayar sends while the store is paused. Click Resume to continue.
• Delete: click Delete, then Delete store. Konektor stops accepting events from that store, and flows that run for that store stop. After that, replace or remove the webhook address in Mayar.

One workspace can have up to 5 stores from all platforms.

Next steps

• Order flows: messages, reminders, and automatic stops
• Manage leads
• Conversion Settings
• WhatsApp Templates
• Partner Integrations