Embedded SDK
Add a seamless checkout directly to your website — no redirects, no hassle!
The myPOS Embedded SDK lets you integrate a secure, fully functional checkout form right into your webpage using an iFrame.
Customers stay on your site for the entire payment process, making checkout faster and boosting conversions.
What is Embedded Checkout?
Embedded Checkout is a myPOS-branded iFrame you can place anywhere on your site.
Customers enter their card details and complete the transaction without leaving your page.
Benefits:
- Keep customers on your website
- No redirects to external payment pages
- Smoother checkout experience
- Higher conversion rates
Note: Google Pay and Apple Pay are currently not supported in Embedded Checkout.
Installation
Choose your preferred installation method:
1. Via NPM or Yarn
npm i mypos-embedded-checkout
2. Direct Script Include
<script src="https://developers.mypos.com/repository/mypos-embedded-sdk.js" type="text/javascript"></script>
Requirements
Make sure these requirements are met before you begin:
-
Public IP Address:
All requests must come from a public IP address. -
HTTPS Required:
Your notification URL (urlNotify) must use HTTPS — HTTP URLs will be rejected. -
Server Response:
When myPOS sends a notification, your server must respond with:- Status code:
HTTP 200 OK - Response body:
OK(plain text)
- Status code:
Important: Any response other than "OK" will be treated as an error and may cause transaction issues.
- iFrame Dimensions:
Minimum recommended size:- Width:
320px - Height:
620px
- Width:
What You'll Learn
This guide covers everything you need:
- Installation steps
- Sample code and examples
- Configuration options
- Event handling
- Testing with test cards