When do you need this guide?
You need it before connecting Payphone in Marketplace, when Brain Studio asks you for these two credentials:- Access Token
- Store ID
- Business Portal: where you manage users and stores
- Developer Portal: where you create the application and obtain the Access Token
Before you begin
You need:- An active Payphone Business account
- At least one active store in that account
- Access to the Payphone developer portal
Steps to obtain credentials
Log in to Payphone Business
- create the developer user
- assign it to the store you will use in the integration
Create a developer user
- First name
- Last name
- Email address
- Password
- Assigned store

User creation form in Payphone Business — select the Developer role and assign the store
Log in to the developer portal
Create an application
- Application name
- Description
- Categories
- Development platform: you can select Java
- Application type: Web
Configure domain and response URL

Application creation form in Payphone Developer — verify that the Type is Web and that the Web domain and Response URL match exactly the values shown
Create the company request
- RUC of the company
- Reason for the request

Company request modal in Payphone Developer — enter your company RUC and the reason before saving
Get the Access Token

Approved request in Payphone Developer — click 'Ver todo el token' to copy the full Access Token
Get the Store ID

Store list in Payphone Developer — copy the StoreId of the store assigned to the developer user
Test and production mode
Payphone uses the same credentials (Access Token and Store ID) for testing and production.- You do not need to generate a separate token
- The environment is controlled from the application configuration in the developer portal
Troubleshooting
The company request is still pending
The company request is still pending
- check the request status in the developer portal
- confirm that the RUC and reason were entered correctly
- verify that the application has the correct domain and response URL configured
I can't find the Store ID
I can't find the Store ID
The token doesn't work in Marketplace
The token doesn't work in Marketplace
- the company request has already been approved
- you copied the full Access Token
- the Store ID corresponds to the correct store
- the developer user is assigned to that store
Best practices
Protect your credentials
Protect your credentials
- Do not share the Access Token or the Store ID
- If you need to rotate the token, do it from the developer portal
- Avoid saving these credentials in public documents or repositories