API Reference

Unlock monetization instantly with easy-to-use API documentation

Welcome to the quick start guide for Pay1st, the all-in-one solution to unlock monetization in new markets. Through a simple step-by-step process, you can start offering your customers local payment methods in your checkout or feature products in the Carry1st Shop to reach new audiences in Africa and the Middle East 👌🎮.


Pay1st Integration Styles

There are two styles of Pay1st Integration:

Shop Integration

Discovery, distribution, and monetization

The Carry1st Shop Integration that allows for the distribution and monetization of products. The user journey is as follows:

  • The customer enters their user ID linked to their account with the Pay1st Partner, which the Shop will validate with the Pay1st Partner to ensure that they exist
  • Once validated, the customer chooses a product and pays for it using the payment method of their choice
  • Once payment is successful, the Shop notifies the Pay1st Partner’s servers to credit the customer with their product
The user journey for making a purchase on Carry1st Shop

The user journey for making a purchase on Carry1st Shop

Gateway Integration

Seamless experience integrating local payment methods

The Gateway Integration allows Pay1st Partners to offer all of Pay1st’s local payment methods in their native checkout experience. The user journey is as follows:

  • The customer initiates a payment using their preferred payment method offered by Pay1st within the Pay1st Partner’s checkout experience
  • The Pay1st Partner sends a payment request to Pay1st and the customer proceeds to complete their payment
  • Once the payment has been successful, Pay1st notifies the Pay1st Partner’s servers to credit the customer with their product
The user journey for making a purchase using our Pay1st Gateway

The user journey for making a purchase using our Pay1st Gateway