Skip to main content
Pix is a Brazilian instant payment method. This page covers Pix through Efí. For Pix through Mercado Pago, see Pix (Mercado Pago). Pix only works on stores whose currency is BRL. Gamecart talks to the Efí Pix API over mTLS, so you upload the .p12 certificate of an Efí application with the right scopes. Efí issues separate credentials for homologation and production. Homologation matches Sandbox mode in Gamecart.

​
Create the Efí application

  1. Sign in to your Efí account.
  2. Open API and create an application.
  3. Enable the Pix API.
  4. Grant these scopes, in production and in homologation:
Without payloadlocation.read, loading the QR code fails with insufficient_scope.
  1. Copy the Client ID and Client secret for the environment you will use.
  2. Download the .p12 certificate issued for that same environment.
  3. Copy a Pix key that belongs to the Efí account.

​
Add it in Gamecart

  1. Open Settings > Gateways and click Add gateway.
  2. Click Add on Pix.
  3. Set Provider to Efí.
  4. Paste the Client ID, Client secret, and Pix key.
  5. Select the .p12 file under P12 certificate. Fill in Certificate password (optional) only if Efí gave the certificate a password.
  6. Sandbox mode starts on. Leave it on for homologation credentials and turn it off for production.
  7. Click Save Configuration.
Configure Pix dialog with Efí selected and the credential fields, certificate, sandbox mode, and required scopes highlighted

With Efí as the provider, the dialog asks for the credentials, the certificate, and lists the required scopes.

  1. Turn on the Pix switch in the gateway list when you are ready to take payments.
The client ID, client secret, certificate, and sandbox setting must all come from the same environment. A production secret with a homologation certificate fails authentication. After you save, Gamecart never shows the certificate again. The dialog only says whether one is configured, and you select a new file only to replace it. You can’t switch this gateway to Mercado Pago while a Pix order is still pending with Efí.