Steps on Linking Outlets

note

This section is intended for facilitator integration. If you are using direct integration, you may proceed without going through this section.

Previously on linking API, the linking API pinpointed automatically to the main outlet that the user are registered to. To be able to exactly pinpoint which outlet that wants to be linked, we enable the Link API for you to be able to pinpoint the outlet by yourself.

Since the Link API needs an outlet ID as a parameter, you can use this API GET /integrations/partner/v1/token-info to check what are the outlet ID’s that is associated with the current user token. For more detail on Linking API please refer on Linking Outlet API. For more detail for authorization code used for access token, please refer here

How can I check for user phone number?

Sometimes, we also notice that there are questions related to the phone number that can be used for OTP verification. So we provide steps on how to easily get the outlet ID:

• User can check their phone number in the main menu or account menu on gobiz app (refer to the guide below)
• The appointed phone number then can be used for OTP verification process

How do I find the phone number that I can use for OTP verification?

You can check your phone number from either Gobiz App Main Page or on Gobiz App Account Page, you should be able to see the phone number in the upper side of the page (as shown on image above)

Linking Outlets

Instead of searching for each user that is associated with each outlet, you just need to get the user to login, get their access token and then they will be able to link all outlets that related to that user.

With that we provide 3 API’s:

• Get All outlets linked to owner GET https://api.gobiz.co.id/integrations/partner/v1/token-info
• Link outlet PUT https://api.gobiz.co.id/integrations/partner/outlets/{outlet_id}/v1/link/{product_name}
• Unlink outlet DELETE https://api.gobiz.co.id/integrations/partner/outlets/{outlet_id}/v1/link/{product_name}

Get All User’s Outlet

1. Please use this endpoint GET https://api.gobiz.co.id/integrations/partner/v1/token-info

2. On authorization choose bearer token type and input your access_token value on token

3. Click Send, if the Token is correct, then the list of outlet under owner will be shown, along with field outlet phone number, name, id, email, address

Linking the Outlet

1. Please use this endpoint PUT https://api.gobiz.co.id/integrations/partner/outlets/{outlet_id}/v1/link/{product_name}

2. On authorization choose bearer token type and input your access_token value on token

3. On Parameter, you need to input outlet_id and product_name

Product name reference (product that you subscribed to)

• gofood (if you're integrated to GoFood product)
• payment (if you're integrated to QRIS Payment)

4. On Request Body, choose Raw and JSON. You can input additional parameter such as External Outlet ID

5. If all parameters are correct, you will get response like this

6. Your order acceptance will automatically set to Auto Accept (please check order acceptance reference)

Unlinking the Outlet

1. Please use this endpoint DELETE https://api.gobiz.co.id/integrations/partner/outlets/{outlet_id}/v1/link/{product_name}

2. On authorization choose Bearer Token type and input your access_token value on Token

3. On Parameter, you need to input outlet_id and product_name

Product name reference (product that you subscribed to)

• gofood (if you're integrated to GoFood product)
• payment (if you're integrated to QRIS Payment)

4. If all parameters are correct, you will get response like this