Skip to main content

Before you begin

This guide assumes that you know how to

Accept payments with CPay via Monext

Prepare the client session

CPay via Monext requires the following data to process a payment successfully. Pass the following data in the client session, or in the payment request (for manual payment creation).
Parameter NameRequiredDescription
currencyCode3-letter currency code in ISO 4217 format, e.g. USD for US dollars
order
lineItems
Details of the line items of the order
metadata
monext_contracts
CPAY
The e-commerce contract code or number

Prepare the SDK for payments

  • Web
  • iOS
  • Android

Show Universal Checkout

CPay via Monext is automatically presented to the customer when calling Primer.showUniversalCheckout.
TypeScript
try {
  await Primer.showUniversalCheckout(clientToken, {
    container: '#checkout-container',
    options,
    onCheckoutComplete({ payment }) {
      console.log('Checkout complete.', payment)
    },
  })
} catch (e) {
  // handle error
}

Customization

Check the customization guide to learn how to customize payment method buttons.
Typescript
const options = {
  /* Other options ... */
  style: {
    paymentMethodButton: {
      background: string,
      borderRadius: number | string,
      boxShadow: string,
      borderColor: string,
      height: number,
      primaryText: TextStyle,
      logoColor: logoColor,
      marginTop: string,
    },
  },
}

Go live

You don’t need to do anything particular to go live — just make sure to use production credentials.