quadpay-merchant-sdk-react-native
v2.1.4
Published
This library provides the ability to offer QuadPay as a payment in your app!
Downloads
291
Readme
QuadPay SDK
The QuadPay SDK enables you to offer buy-now-pay-later functionality in your iOS app!
See: https://docs.quadpay.com/docs/mobile-sdk-ios https://docs.quadpay.com/docs/mobile-sdk-android
for details about what the native implementation looks like
Installation
The QuadPay SDK requires react-native >0.59 and uses autolinking -- no extra steps required.
Standard Checkout Example
import { QuadPay } from "quadpay-merchant-sdk-react-native";
...
// Be sure to init the QuadPay library before making any calls!
merchantId = "44444444-4444-4444-4444-444444444444";
// Be sure to make sure your Merchant ID is for the correct environment!
environment = "SANDBOX"; // "SANDBOX" or "PRODUCTION"
locale = "US";
QuadPay.initialize(merchantId, environment, locale);
// Add details about the customer and their order
// these will be used to autofill fields during the QuadPay checkout
order = {
amount: "44.44",
merchantReference: "custom-order-id",
customerFirstName: "Quincy",
customerEmail: "<use a unique email>@<test>.com",
customerLastName: "Payman",
customerPhoneNumber: "+14076901147",
customerAddressLine1: "240 Meeker Ave",
customerAddressLine2: "Apt 35",
customerPostalCode: "11211",
customerCity: "Brooklyn",
customerState: "NY",
customerCountry: "US",
merchantFeeForPaymentPlan: "0",
};
// Register callbacks with the QuadPay library -- these will fire when the customer
// completes or cancels checkout
// There is no need to "unregister" any of the callbacks
QuadPay.onCheckoutSuccessful(successfulCheckout => console.log(successfulCheckout));
// The user has completed checkout -- successfulCheckout.orderId must be used to confirm the transaction from the backend
// Handle edge cases
QuadPay.onCheckoutCancelled(reason => console.log(reason));
QuadPay.onCheckoutError(errorMessage => console.log(errorMessage));
// Open the QuadPay checkout view
QuadPay.startCheckout(order);
Virtual Checkout Example
import { QuadPay } from "quadpay-merchant-sdk-react-native";
...
// Be sure to init the QuadPay library before making any calls!
merchantId = "44444444-4444-4444-4444-444444444444";
// Be sure to make sure your Merchant ID is for the correct environment!
environment = "SANDBOX"; // "SANDBOX" or "PRODUCTION"
locale = "US";
QuadPay.initialize(merchantId, environment, locale);
// Add details about the customer and their order
// these will be used to autofill fields during the QuadPay checkout
order = {
amount: "44.44",
merchantReference: "custom-order-id",
customerFirstName: "Quincy",
customerEmail: "<use a unique email>@<test>.com",
customerLastName: "Payman",
customerPhoneNumber: "+14076901147",
customerAddressLine1: "240 Meeker Ave",
customerAddressLine2: "Apt 35",
customerPostalCode: "11211",
customerCity: "Brooklyn",
customerState: "NY",
customerCountry: "US",
merchantFeeForPaymentPlan: "0",
};
// Register callbacks with the QuadPay library -- these will fire when the customer
// completes or cancels checkout
// There is no need to "unregister" any of the callbacks
QuadPay.onCheckoutSuccessful(successfulCheckout => console.log(successfulCheckout));
// Submit the card and cardholder details through your standard payment processor!
// Handle edge cases
QuadPay.onCheckoutCancelled(reason => console.log(reason));
QuadPay.onCheckoutError(errorMessage => console.log(errorMessage));
// Open the QuadPay checkout view
QuadPay.startVirtualCheckout(order);
Widget Example
import ZipWidget from "quadpay-merchant-sdk-react-native/ZipWidget";
...
<ZipWidget
alignment="center"
size="100"
logoSize="140"
isMFPPMerchant="true"
merchantId="9f7c8dcc-a546-45e4-a789-b65055abe0db"
max="20"
amount="30"
colorPrice="#BB361A"
/>
Payment Widget Example
import ZipPaymentWidget from 'quadpay-merchant-sdk-react-native/ZipPaymentWidget'
...
<ZipPaymentWidget
amount="100"
isMFPPMerchant ="true"
learnMoreUrl ={learnMoreUrl}
/>