- Getting Started
- Primeiro Pay
- Mobile SDK
- Manage Payments
- API Reference
- Result Codes
- Brands Reference
Ready-to-Use Checkout Screens
To speed up your development process, we provide ready-to-use checkout screens. This takes away the burden of having to design and implement your own checkout screens. These screens define a customizable checkout flow which integrates nicely into your application.
There are two ways you can use our checkout screens. The following table will help you choose the solution that works best for you.
|Drop-In Checkout||Drop-In Forms and Payment Buttons|
|Integration steps||1. Set list of supported payment brands
2. Present checkout screens
|1. Create payment button
2. Present checkout for specific payment brand
|First presented screen||List of payment brands
and stored cards (optionally)
Depends on specific payment brand:
|Benefits||1. Ready screen with list of payment brands||1. More flexible solution, use drop-in buttons or any other controls to display payment brands
2. The best way to add specific payment brand to your app
In case of synchronous payments, shopper's payment details are collected only in the app. No redirects for additional checks and authentication are needed.
To learn how to integrate SDK with our prebuilt checkout forms, follow the First Integration guide.
For some payment methods additional shopper verification (3D Secure) or account authentication is required. In this case the shopper will be redirected from the payment form to the issuer page to verify his identity.
See how to configure your app to return from app switches in Asynchronous payments guide.
Checkout Screens Customization
Brand managementThere are 2 possible ways to set brands for your checkout:
- In your app (see Configuring Checkout Settings)
- In the merchant and administration portal (BIP) - allowing to update the brands offered to shoppers without requiring an update of the mobile app.
Located under "Administration > Primeiro Pay > Categories > Brands", you optionally can define which brands are displayed in the checkout by configuring the "Allowed Brands" on a channel, or any of its parents/ancestors.
To activate the brand configuration through the merchant and administration portal (BIP), first set the "Activate Brand Management" to TRUE.The last setting "Override shop brands" is used to decide on the policy to propagate new Brands you enter to the checkout:
- Either override whatever was defined in the shop. (Value TRUE)
- Or offer only brands for payment, that are both specified in the BIP and in the checkout settings in the app (Value FALSE, default)
We built the Checkout project so that from the default theme that we provide you can define your own appearance and apply the attributes you want to customize.
Full reference can be found in the Customization guide.
Our prebuilt checkout UI currently supports 8 languages (English, German, Russian, Thai, Japanese, French, Spanish and Portuguese).
You are also able to add your own translations or change text for existing ones.
You can find detailed instructions in the Internationalization guide.
Credit card scanning
You can scan your credit card to enter your payment information for a purchase, saving you from having to key in your digits manually.
This feature is not enabled by default, refer to the Card scanning guide for integration details.
Store payment details
You can enable option to store payment details, it is supported for credit card and bank account details.
Shopper's payment details are stored with unique identifier (token), which can be used for future payments.
You can find more details in the Tokenization guide.
Checkout project provides an opportunity to skip CVV request for all cards or only for stored ones.