Apruve

The Apruve Developer Hub

Welcome to the Apruve developer hub. You'll find comprehensive guides and documentation to help you start working with Apruve as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Integrating with Magento 1.x

Apruve has developed an Apruve payments extension for Magento. It allows your customers to choose Apruve as the payment method during the checkout process. Once the order is submitted we will take care of the invoicing and payments.

You can find the extension on the Magento Marketplace website (1.x).

Make it yours, or help us make it better.

The extension is 100% open source, so you can do whatever you need to make it work with your store. Think other Magento store owners would benefit from your improvements? Send us a pull request.

Fork our project on GitHub.

Step 1 - Create an Apruve Merchant account

In the Magento Apruve configuration you have the choice of selecting one of two modes: Test or Production. We suggest that you test your store in Test mode first to ensure that the integration is working properly. Then you can switch it to Production and begin accepting orders.

If you want to integrate with Apruve's test or production (live) servers, you can contact us to get started.

You will receive an email containing a link to confirm the account - you'll need to confirm it before you can move forward and use it.

Step 2 - Install the Extension

In this step, we'll add the Magento Extension for Apruve to your Magento store.

Get the Extension Key

Visit the Magento Marketplace page for the extension 1.x or 2.x.

extension page

Click the "Add to Cart" button.
extension install button

Go to the Checkout page.
extension checkout button

Fill out the order form and click "Place Order".
magento order form

Click the "Install" button from the order confirmation page, which will bring you to a page containing your access keys.

Then, click the "Copy" link to copy the key to your clipboard.
copy extension key

Install the Extension

Log into the Admin Panel of your Magento store.
admin panel login

Navigate to System -> Magento Connect -> Magento Connect Manager. Re-enter your admin credentials if required.
config menu

Paste the key you copied above into the Install New Extensions field, and click install.
paste extension key

Click Proceed.
click proceed

If it is successful, it will show something like this. Click Refresh when complete.
click refresh

When the page refreshes, you should see the Apruve extension in your list of installed extensions. It may be at the bottom of the list.
click refresh

Scroll to the top of the page, and click Return to Admin.
return to admin panel

Step 3 - Configure the Extension

Now that the extension has been installed on your Magento store, we'll connect your Magento store to your account on
Apruve.

Enable the extension, and set test vs. production

In your Magento Admin Panel, navigate to System -> Configuration
admin config menu

On the left, click on Payment Methods.
payment methods menu

Expand the Apruve Payment section.
apruve payments configuration

Set Enabled to true and Test Mode to Yes if connecting to test.apruve.com. (set Test Mode to No if connecting to app.apruve.com)
enabled, test

Set your Merchant ID

Open another browser window... Log into your Apruve, view your store profile (on test: https://test.apruve.com/
or on production: https://app.apruve.com/.

You can find your Merchant ID by clicking on "Settings" and then on the "Technical" tab. Copy the Merchant ID to your clipboard.

enabled, test

Back in your Magento Admin Panel... paste in the value for your Merchant ID
merchant key

Set the API Key

Back In the Apruve window... Locate your API Key or follow the instructions to create one.

Copy the API Key to your clipboard

create api-key

Back in your Admin Panel... paste in the value for your API Key

merchant key

Save your configuration

merchant key

Step 4 - Set the Web Hook

Your Magento store is now connected to Apruve. The only thing left to do is to tell Apruve how to contact your store when someone pays for your shopper's purchase. This is done through something called a "Web Hook".

Set your store's Web Hook URL in Apruve

When you saved your Apruve Payment configuration in the Admin Panel, a Webhook URL was created. Copy this to your clipboard.

admin config menu

In the Apruve window... Pase the Webhook URL into the Notifications section. The "Webhook Version" should be set to "v4".

apruve technical nav

Paste the Webhook URL in the field, and save.

Important - you will need to clear the Magento cache before you attempt to use Apruve as a payment method in checkout!

Step 5 - Test

The Magento Extension for Apruve is now installed and configured.

Let's buy something!

Go through a complete transaction, selecting Apruve as the payment method.

magento checkout with Apruve

Once the checkout process is complete, your order status should show Pending. This means your API Key and Merchant ID are configured correctly.
pending status

When the merchant logs into Magento admin and ships the item Apruve will create an invoice automatically for the items shipped and pass the shipping and invoice details to Apruve.

The invoices generated in Magento will be “Pending” status and when the invoice is closed in Apruve the status for invoice in Magento will change to “Paid”. This means your Webhook URL is configured correctly.

If all the items are shipped and invoiced, and the invoice is closed/paid the order status changes to “Complete” in Magento.

Key Notes

  • Once shipped an invoice should not be canceled.
  • Once an order is accepted in Apruve it cannot be canceled.
  • Returns or Refunds need to be handled separately in Magento and Apruve

processing status

All done...?

At this point, make sure you test anything else related to your payment and order processing to ensure it works as you expect with Apruve.

If you have any questions, drop us a line at hello@apruve.com.
And don't forget, all the source code for the extension can be found on our GitHub page.