# react-native-rn-mia

> A react native module that wraps and bridges Mia iOS and Android SDKs

Latest version **1.6.1** (published 2022-08-05) · MIT license · 0 weekly downloads

## Install

```sh
npm install react-native-rn-mia
pnpm add react-native-rn-mia
yarn add react-native-rn-mia
bun add react-native-rn-mia
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.6.1 |
| Published | 2022-08-05 |
| First published | 2020-05-26 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 3.1 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | mobile-acceptance |
| Keywords | react-native |

## Links

- npm: https://www.npmjs.com/package/react-native-rn-mia
- Repository: https://github.com/github_account/react-native-rn-mia
- Homepage: https://github.com/github_account/react-native-rn-mia#readme
- Issues: https://github.com/github_account/react-native-rn-mia/issues
- npm.io page: https://npm.io/package/react-native-rn-mia

## Recent versions

- 1.6.1 (latest) — 2022-08-05
- 1.6.0 — 2021-11-10
- 1.2.0 — 2021-02-02
- 1.0.7 — 2020-05-27
- 1.0.6 — 2020-05-27
- 1.0.5 — 2020-05-26
- 1.0.4 — 2020-05-26
- 1.0.3 — 2020-05-26
- 1.0.2 — 2020-05-26
- 1.0.1 — 2020-05-26

## README

# react-native-rn-mia


## Installation

`$ npm install react-native-rn-mia --save`

This links the module in Android but more steps are required to complete the *iOS* integration.

    - Navigate to the ios folder and install pods: `cd ios && pod install && cd ..`

    - Open your application xcworkspace and add Mia.framework to the Libraries folder
        - Right click on Libraries - Add Files to "Your project" and find Mia.framework in *react-native-rn-mia/ios* directory
        - Under application target - *Frameworks, Libraries, and Embedded Content*, select *Embed & Sign* for Mia.framework


## Usage (Access Mia API)

The react native wrapper module can be accessed from your javascript by importing RNMia module. 
```js
import RNMia from 'react-native-rn-mia';
```

### Mia Checkout API

Present Mia checkout after obtaining a payment ID and payment URL from Nets Easy `create payment` REST API.
See the [example](### Example - Create Payment with Nets Easy) to create payment with order and merchant details.

```js
// This example presents Mia SDK's checkout WebView and handles 
// the callbacks by presenting an alert accordingly
RNMia.checkoutWithPaymentID(paymentID, paymentURL, redirectURL, 
(error) => {
   alertTitle = error ? "Error" : "Payment Successful"
   Alert.alert(alertTitle, error, [{text:"Ok"}])
}, 
(cancellation) => {
   Alert.alert("Cancelled", "You have cancelled the payment", [{text:"Ok"}])
});
```

Note: A redirect URL is used to identify navigation from Mia SDK back to the application.
Pass the same `redirectURL` when creating the payment with Nets Easy API and 
when presenting checkout with Mia SDK as shown above. 

Callbacks:
    - Success: The first callback is invoked with no `error` if payment was successful
    - Failure: The first callback returns an `error` map object in case of error. User "Error" key to obtain error message. 
    - Cancellation: The second callback is invoked if the user cancelled the process. The callback does not contain any argument. 

### Example (Create Payment with Nets Easy)

Create the request body:

```js 
requestBody = {
    "checkout": {
        "termsUrl": URL,
        "returnURL": redirectURL,
        "consumerType": {
            "supportedTypes": [
                "B2C",
                "B2B"
             ],
            "default": "B2C"
        },
        "integrationType": "HostedPaymentPage"
    },
    "order": {
        "reference": "reference",
        "currency": "SEK",
        "amount": amount,
        "items": [
            {
                "unit": "pcs",
                "netTotalAmount": amount,
                "taxAmount": 0,
                "grossTotalAmount": amount,
                "quantity": 1,
                "name": "Lightning Cable",
                "unitPrice": amount,
                "taxRate": 0,
                "reference": "reference"
             }
        ]
    },
}
```

Initiate payment using your merchant secret key to authorize with Nets Easy

```js 
// Test env. is used for this demo
baseURL = "https://test.api.dibspayment.eu/v1/"
fetch(baseURL + '/payments', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Token ' + secretKey
    },
    body: JSON.stringify(requestBody),
})
.then((response) => response.json())
.then((json) => {

    // Use these `paymentID` and `paymentURL` to present Mia SDK (see above)
    paymentID = json.paymentId 
    paymentURL = json.hostedPaymentPageUrl  
    
})
.catch((error) => {
    console.error(error);
});
```

Mia SDK presents a checkout WebView with the payment information and returns 
the result to the application via callbacks.

In order to initiate a subscription payment, include a `subscription` key in the request body 
containing `endDate` and `interval` values. See EasyAPI.js of the sample app for a complete example.

---
_Source: https://npm.io/package/react-native-rn-mia · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._