MoneyHash's Embedded Experience allows you to integrate seamlessly by using a URL, either on an
iframe or by redirecting your customer to a new page.
To use the Embedded integration, you need to create an intent for each transaction through API calls. The response from the intent creation endpoint provides the 'embed_url' which will provide the necessary URL for the integration.
Before starting using the Embedded integration, be sure to have completed the steps described below.
- Get Started with MoneyHash to access your own Organization.
- Create an Account within your Organization.
- Connect providers to your new Account.
- Set up your Payment Defaults.
- Get your API keys in the dashboard to make API calls.
To use Embedded integration, you need to start by creating a new intent through an API call to the Payment intent endpoint:
To use MoneyHash endpoints, you need to provide correct authentication information. Otherwise, you will not be able to create intents or perform other requests to MoneyHash API.
At the intent creation, you are able to send an object as parameter in the
custom_fields key. For example,
if you already have this customer's information you may desire to send this data here, eliminating the need
for this customer to type in his personal information again
The response from the Payment intent endpoint will
contain all information related to the newly created intent. You find the URL to embed the payment on your page
and show your customer the checkout experience at
response.data.embed_url. As mentioned above, you
can embed the URL content through an iframe or redirect customers to a new page.
You can render the
iframe directly in your HTML like this:
<iframe src ="https://embed.moneyhash.io/embed/payment/LWa7PYZ"></iframe>
You can use the URL recovered to redirect your customer in a few ways, for example, using an
With these steps, your customer will be presented with the Embedded integration provided by MoneyHash, and they will be able to perform their payment. Examples of this solution can be seen in our Sandbox feature.
Here are some query parameters you can add to the embed URL to change the UI of the loader.
loader[backgroundColor] -> controls the background color
loader[color] -> controls the spinner color
loader[icon] -> Custom loader icon (image url)
loader[size] -> controls loader icon/spinner size
loader[animate]=true -> enable the spinner animation on the custom loader
After integrating with MoneyHash through the Embedded Experience, it's recommended you learn how to configure and use Webhooks and Redirects to receive notifications and automatically redirect your customer.
Updated about 11 hours ago