{"type":"doc","content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"If a client is onboarded with MCB MIDs:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Onboard brand on XAP","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Send a welcome note/msg in the group to the client","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ask the client for these details in the welcome note (Merchant ID, Operator ID, Bank Operator Password, API Password)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ask the client to send an email to the bank for the webhook enablement: (Pls write down this email to the MCB team :","type":"text"}]},{"type":"paragraph","content":[{"text":"Hi Bank MCB team,","type":"text"}]},{"type":"paragraph","content":[{"text":"XStak is the technology facilitator for our brand and a PCI DSS-certified entity.","type":"text"}]},{"type":"paragraph","content":[{"text":"Kindly enable the webhooks and direct APIs on our MID xxxxxxxxxxx(write your MID).","type":"text"}]},{"type":"paragraph","content":[{"text":"And send to the following in addition to your person of contact there","type":"text"}]},{"type":"paragraph","content":[{"text":"mohammadali.khan@mcb.com.pk","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:mohammadali.khan@mcb.com.pk"}}]}]},{"type":"paragraph","content":[{"text":"maryam.hassan@mcb.com.pk","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:maryam.hassan@mcb.com.pk"}}]}]},{"type":"paragraph","content":[{"text":"Please copy:","type":"text"},{"text":"omer.zia@xstak.com","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"mailto:omer.zia@xstak.com"}}]},{"text":", ","type":"text"},{"text":"noreen.ayesha@xstak.com","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"mailto:noreen.ayesha@xstak.com"}}]},{"text":", ","type":"text"},{"text":"afrashum.waseem@xstak.com","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"mailto:afrashum.waseem@xstak.com"}}]},{"text":", ","type":"text"},{"text":"waleed@xstak.com","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"mailto:waleed@xstak.com"}}]},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"And let us know when these are enabled.).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Shopify integration (App installation, Add the script in the checkout tab, Add a manual payment method)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"XAP integration (Add Shopify details and Gateway details)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 1: Client onboarding on XAP","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl --location 'https://api.copilot-live.xstak.com/v1/realm/create' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"realm\": \"Laam\",\n \"username\":\"admin-tools@xstak.com\",\"email\":\"admin-tools@xstak.com\",\"firstName\":\"Admin\",\"lastName\":\"tools\",\"realmRoles\":[\"xpay\"],\"userRoles\": [\"xpay\"]\n}'","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 2: Shopify Integration","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"App Installation:","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"Go to settings> Apps and sales channel> Click on develop app> Select create an app> Write XPay App> Add scopes","type":"text"}]},{"type":"paragraph","content":[{"text":"List of scopes to select:","type":"text","marks":[{"type":"underline"},{"type":"strong"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Admin API integration:","type":"text"}]},{"type":"paragraph","content":[{"text":"write_order_edits, read_order_edits, write_orders, read_orders, write_themes, read_themes, write_content, read_content, write_products, read_products, read_customers","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Storefront API integration:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"unauthenticated_write_checkouts, unauthenticated_read_checkouts, unauthenticated_write_customers, unauthenticated_read_customers,unauthenticated_read_product_listings","type":"text","marks":[{"type":"code"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Save the Storefront API access token, API Access token, API Secret key, and API key","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add script in the checkout tab:","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on","type":"text"},{"text":" the Checkout tab","type":"text","marks":[{"type":"strong"}]},{"text":" scroll down, and Select Additional Scripts. Do not change existing ones just place your script under existing scripts:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"\n","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"orderedList","attrs":{"order":3},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add manual payment method:","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on ","type":"text"},{"text":"Payments, ","type":"text","marks":[{"type":"strong"}]},{"text":"and scroll down to find","type":"text"},{"text":" Add custom payment method","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the name of your payment method i.e. Credit/Debit Card - XPay","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add this message in additional details:","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"“You will be redirected to XPay Payment Gateway, where you can use any Credit/Debit card to complete your purchase securely.“","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 3: Onboarded brand on XAP","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Login to the XAP portal using Xap credentials> Set password from keycloack to login","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to settings","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add ","type":"text"},{"text":"Shopify details","type":"text","marks":[{"type":"strong"}]},{"text":" given below:","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1536,"alt":"image-20240319-151553.png","id":"3930924d-2235-4c46-a8fa-dcd5ed618faf","collection":"contentId-10332307475","type":"file","height":699}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 4: Gateway Integration","type":"text"}]},{"type":"paragraph","content":[{"text":"To integrate MCB:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"First, we need a webhook secret and to generate a webhook follow the following steps:","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MCB Portal Link: ","type":"text","marks":[{"type":"strong"}]},{"type":"inlineCard","attrs":{"url":"https://mcbpk.gateway.mastercard.com/ma/login.s"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add login details provided by the Client (Merchant ID, Operator ID, and Password)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We need to fetch the Webhook secret from the BAFL portal","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For ","type":"text"},{"text":"Webhook Secret ","type":"text","marks":[{"type":"strong"}]},{"text":"go to the MCB portal and Click on the ADMIN tab.","type":"text"}]}]},{"type":"listItem","content":[{"type":"mediaSingle","attrs":{"layout":"center","width":618,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":618,"alt":"image-20240710-061958.png","id":"3bc9ad90-e611-405b-89e8-6d760f2a874b","collection":"contentId-10332307475","type":"file","height":263}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on WEBHOOK NOTIFICATIONS > ENABLE WEBHOOK > GENERATE NEW SECRET > SAVE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy the generated secret key and place it in Webhook Secret on the XPay portal","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add details on the XAP portal","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to settings> gateway","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on Add instance","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select MCB in acquirer and add these details:","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1536,"alt":"image-20240319-161554.png","id":"24bbf352-1d2d-4eec-a9eb-10431ac3bd1f","collection":"contentId-10332307475","type":"file","height":694}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 5: User creation","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ask clients to share email addresses via which they will be accessing the XPay portal","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create accounts via user management","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 6: Placed test order","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now place the test order to test the whole flow","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can ask the client to share the URL of a test product with a price of Rs#10 (no shipping charges) and with some inventory. Place a test order on it.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enable XPay from Payment method","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After selecting it you will be redirected to this page:","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":608,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":608,"alt":"image-20240319-153752.png","id":"66c945c8-fd72-4b0f-90a0-96c9096dc2de","collection":"contentId-10332307475","type":"file","height":632}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}],"version":1}

Browser not supported