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

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.