Skip to content

Commit

Permalink
Merge branch 'development' into WooCommerce-Credentials-link-correction
Browse files Browse the repository at this point in the history
  • Loading branch information
@abderossi
abderossi authored Oct 1, 2021
2 parents f86897f + 0d4ac39 commit 176c385
Show file tree
Hide file tree
Showing 109 changed files with 4,357 additions and 2,857 deletions.
61 changes: 31 additions & 30 deletions guides/in-person-payments/mp-point/how-to-integrate.en.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ sites_supported:

# How to integrate Mercado Pago Point

In order to be able to process payments in the integrated mode with our Point devices, it is necessary to download the Mercado Pago application for Android and IOS.
In order to process payments in the *integrated mode* with our Point devices, it is necessary to download the Mercado Pago application for Android and IOS.

There are two different possible situations to integrate Point:

1) When you can access your application from the same device (smartphone or tablet) where the Mercado Pago application is installed. This integrations can be done vía Deep linking or Intent-based.
1) When you are able to access your application from the same device (smartphone or tablet) where the Mercado Pago application is installed. These integrations can be done via Deep linking or Intent-based.

2) When you can not use your application from the same device (smartphone or tablet) where the Mercado Pago application is installed. This integration can be done vía API.

Expand All @@ -23,15 +23,15 @@ There are two different possible situations to integrate Point:
>
> * You must have the Mercado Pago application (From version 2.34 for Android and 2.32 for iOS).
> * Have a Point device.
> * The user must be logged in with his Mercado Pago account in the application.
> * The user must be logged in with their Mercado Pago account in the application.
> * Avaliable for Android version 2.8.0 or superior, iOS version 1.7.0 or superior and only when it´s in a iOS 9 environment or superior.

## Deep Linking integration
## Integration via Deep Linking

When you call _link_, it is goint to be catched like a _Point-handled address_ by the Mercado Pago application.
One of the ways to integrate with Mercado Pago is via Deep Linking. When said _link_ is called, it is intercepted as a _Point-handled address_ by the Mercado Pago application.

In the "call" to the _link_ you can send different parameters that will be taken by the Mercado Pago application and will impact in the payment. Once you´ve made that call to the previously defined link, the user will be redirected to the Mercado Pago appllication to swipe the card and make the purchase.
In the "call" to this _link_ you can send different parameters that will be taken by the Mercado Pago application and will impact the payment. Once you´ve made that call to the previously defined link, the user will be redirected to the Mercado Pago application to swipe the card and make the purchase.

Once the payment is proccesed, the user will be redirected to the `success_url` or `fail_url`, depending on the result. This must be intercepted to return the user to the application.

Expand All @@ -42,29 +42,29 @@ Once the payment is proccesed, the user will be redirected to the `success_url`

### Deep Linking creation

The URL to be interceptedis the following: `https://www.mercadopago.com/point/integrations`
The URL to be intercepted is the following: `https://www.mercadopago.com/point/integrations`

The parameters tha you can include are:
The parameters that you can include are:

* `amount`: The amount that will be charge to the client (\*).
* `amount`: The amount that will be charged to the client (\*).
* `description`: Description of the operation (Máx.: 20 caracters) (\*).
* `external_reference`: The external_reference is reference code that will allow you to track the Mercado Pago payment_id in your system.
* `external_reference`: The `external_reference` is a reference code that allows you to track the Mercado Pago `payment_id` in your system.
* `notification_url`: The URL where you will receive the notifications.
* `payer_email`: Email of the payer.
* `success_url`: The URL where the user will be redirected when the payment succeded.
* `fail_url`: The URL where the user will be redirected when the payment was rejected.
* `success_url`: The URL where the user will be redirected when the payment succeeds.
* `fail_url`: The URL where the user will be redirected when the payment is rejected.

> WARNING
>
> Important
>
> * The fields with a (\*), are mandatory.
> * The fields with an (\*), are mandatory.

In the [GitHub] article (https://github.com/mercadopago/point-android_integration#deep-linking) you can find more information and a desrcriptive example. podes obtener más información y el ejemplo correspondiente.
In the following [GitHub] article (https://github.com/mercadopago/point-android_integration#deep-linking) you can find more information, as well as a descriptive example.


## Integración vía Intent-Based
## Integration via Intent-Based

> WARNING
>
Expand Down Expand Up @@ -102,16 +102,16 @@ In order to integrate through our APIs, you have to enable the integration optio
} ’
```

Next it is necessary to configure the `device_name` from the Mercado Pago application. It serves to identify your cell phone or tablet and relate it to your Mercado Pago account. In this way, you will know to which device to send the payment order.
Next, it is necessary to configure the `device_name` from the Mercado Pago application. It is used to identify your cell phone or tablet and relate it to your Mercado Pago account. In this way, you will know which device to send the payment order to.

The next step consist in generating a payment order and sending it via API to the corresponding device. The user will see in the screen of the device the order sent to the application. This means that the user is going to be able to swipe the card at that moment and continue with the proccess.
The next step consist in generating a payment order and sending it via API to the corresponding device. The user will see the order sent to the application in the device's screen. It means that the user will be able to swipe the card at that moment and continue with the process.

Once the payment is processed, the user will see the result in the Mercado Pago application. Finally, the order will close and the corresponding payment will be created


### Payment creation

The POST to the API generates an order that Mercado Pago application receives in order to charge via the Point device. You´ll get an id that you could use to know the state of it.
The POST to the API generates an order that the Mercado Pago application receives in order to charge via the Point device. You´ll get an id that you could use to know the state of it.

```curl
curl -X POST \
Expand All @@ -123,22 +123,22 @@ curl -X POST \

The parameters that can be included are:

* `amount`: The amount that will be charge to the client (\*).
* `amount`: The amount that will be charged to the client (\*).
* `description`: Description of the operation (Máx.: 20 caracters) (\*).
* `device_name`: Name of the device in which you want to process the payment. (\*).
* `cc_type`: Card type. Credit or debit card (\*).
* `external_reference`: The external_reference is reference code that will allow you to track the Mercado Pago payment_id in your system.
* `disable_back_button`: True o False. To define wether you want the order to close or not by clicking the back button.
* `external_reference`: The `external_reference` is a reference code that allows you to track the Mercado Pago `payment_id` in your system.
* `disable_back_button`: True or False. This is used to define whether you want or not the order to close by clicking on the back button.
* `notification_url`: The URL where you will receive the notifications.
* `payer_email`: Email of the payer.

> WARNING
>
> Important
>
> * The fields with a (\*), are mandatory.
> * The fields with an (\*), are mandatory.
The answer will have the following format:
The response will have the following format:

```json
{
Expand Down Expand Up @@ -177,7 +177,7 @@ If the order status is `OPEN`, it means that it has not yet been paid. If the st

### Delete the payment order

The DELETE in this API enables you to delete an order. You have to ways of doing so:
The DELETE in this API enables you to delete an order. You have two ways of doing so:

By `device_name`:

Expand Down Expand Up @@ -212,7 +212,7 @@ curl -X DELETE \

### Get all the devices from an account

The GET in this API enables you to get the configured and sincronized devices for your Mercado Pago account.
The GET in this API enables you to obtain all configured and synchronized devices for your Mercado Pago account.

```curl
curl -X GET \
Expand Down Expand Up @@ -242,7 +242,7 @@ If the status of the device is `FREE`, it means that the device can receive a ne

### Delete a device from an account

The DELETE in this API enables you to delete configured and sincronized devices from your Mercado Pago account.
The DELETE in this API enables you to delete configured and synchronized devices from your Mercado Pago account.


```curl
Expand All @@ -265,15 +265,16 @@ The answer will have the following format.

## Payment notifications

It is necessary that you send the `notification_url`, where you´ll get the notification about current and new payments.
It is necessary that you send the `notification_url`, where you'll receive notifications about new payments and status updates generated.

In the article [notificaciones](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/notifications/webhooks) you could find more information about it.
For more information, check the [notifications](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/notifications/webhooks) article.


## Point payments
Point payments can be search in the Payments API. You can find more information in the following article: [API's](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/reference/payments/_payments_id/get)

On the other hand, we have an exclusive Point API that has some additional information about the payments:
Point payments can be searched in the Payments API. For more information, check the [API's](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/reference/payments/_payments_id/get) article.

We also have an exclusive Point API that has some additional information about the payments:


```curl
Expand Down
Loading

0 comments on commit 176c385

Please sign in to comment.