Overview

This section presents the integration methods MoneyHash made available to you. In addition, this section provides guides to help you choose the ideal connection option for your business and how to perform the integration process successfully.

You will find an overview of the integrations and their difference on this page. The aim is to assist you with choosing the one that best suits your case. You can also check the required stages to complete the integration process with MoneyHash.

MoneyHash integration scenarios

Before presenting the methods to integrate with MoneyHash, we would like to share scenarios to help you choose between the options available. Below, you find scenario descriptions and the recommended integration option.

Scenario description	PCI compliance required	Recommended integration
Quick, resource-efficient integration without customizing the checkout process.	❌	Hosted Page
Fast integration without necessarily redirecting customers to different pages.	❌	Embedded
Consistent integration for web and mobile with a similar development experience for all platforms.	❌	SDKs
Additional control and customization over the checkout process.	❌	External API
Full control for a highly customized checkout user experience.	✅	Direct API

Scenarios and integrations

The recommendations for each scenario in the above table are not mandatory. When using MoneyHash you have complete control over the integration option for your business. The recommendations provided are based on previous merchants experience. They are intended to help new merchants who need clarification on what is best for their business.

If you're unsure which integration is best for your business, you can check each option description next on this page, contact our support team, or use the documentation chatbot.

Integration options

MoneyHash offers multiple ways to integrate its services into your system. Below, you can find details about each option and understand their differences.

Hosted Page

This is the simplest and quickest way to integrate with MoneyHash. No coding is required. You only need to have access to our dashboard to be able to create a link to the Hosted Page. You will redirect your clients to this link when it's time for them to perform the payment. Moneyhash fully controls the payment process, and no customizations are available.

Embedded

This option requires API calls and is similar to the Hosted Page, but it offers more flexibility. You need to create an intent by calling our API. The response will provide you with a URL. You can redirect your customer to the provided URL or use an iframe to embed the checkout into your webpage. Additionally, this integration allows you to send information within the request to improve your customer's experience.

JavaScript SDK

You can use the JS SDK option for Web applications. The SDK option allows you to customize your customer's checkout experience and align the checkout to your website's styles.

Mobile SDKs

You can use the mobile SDK options for mobile applications. MoneyHash provides different SDK versions to cover all operational systems. These SDK options allow you to customize your customer's checkout experience and align the checkout to your app styles.

External API

Perform a complete integration based on API calls. Use our various endpoints to create intents and transactions, execute payments, and more. Here, you are not required to be PCI compliant, as MoneyHash still collects customer's payment information.

Direct API

Perform a complete integration based on API calls. Use our various endpoints to create intents and transactions, execute payments, and more. This integration requires you to be PCI compliant, and you will be in charge of every step of your customer's experience, including acquiring the payment information from your customer.

The table below summarizes the differences between all MoneyHash integration options.

Feature	Hosted Page	Embedded	SDKs	External API	Direct API
Requires API Calls	❌	✅	✅	✅	✅
Can Update Custom Fields	❌	✅	✅	✅	✅
Customized Method Selection	❌	❌	✅	✅	✅
Customized Card Form	❌	❌	❌	❌	✅
Customized Success and Failure Screens	❌	❌	✅	✅	✅
Customized Expired and Closed Screens	❌	❌	✅	✅	✅
Supports Native Pay (GooglePay, ApplePay)	❌	❌	✅	✅	✅

Intent creation

In MoneyHash, every payment starts with an intent. With the integration choices you have, the glossary:HPP is the only one that you are not required to make an API call to create the intent yourself.

Integration stages

Below, we list the steps you need to take to integrate with MoneyHash.

Choose the integration option that best fits your business.
Follow the required steps presented in this documentation to integrate correctly.
Test your integration to avoid future problems.
Configure a way to receive notifications from MoneyHash. You have two options:
- Webhooks: Receive on-time notifications of every event on a URL defined by you.
- Redirects: Give MoneyHash the power to redirect your customer directly to your desired page for each event that may happen.

Notification recommendation

MoneyHash recommends you to set up one of the notifications options for every integration you might choose. The only exception is when using the HPP integration, but in this case you can access the information though the MoneyHash dashboard. Webhooks and Redirects are the only ways to be notified when MoneyHash is handling the payment process. Without these option configured, your application will not be capable of knowing about your customers actions.