Get Application Clients

GET/v3/partner/merchant/{merchantId}/applications

This endpoint is for merchants with a Partner account. To activate a Partner account, contact us.

What is this?

Retrieve a list of all application clients associated with a specific merchant under your Partner account. Each application client contains credentials used for OAuth authentication.

When to Use

Use this endpoint when:

• You need to view all application clients for a merchant
• Retrieving clientId and clientSecret for OAuth flows
• Auditing which applications are registered for a merchant

---

How to Use

Step 1: Get the Merchant ID

Locate the merchantId for the merchant whose applications you want to retrieve. You can get this from the Get Merchants endpoint.

Step 2: Make the GET Request

Include the merchantId as a path parameter in the URL. No request body is required.

Step 3: Review the Response

The response contains an items array with all application clients. Note the clientId and clientSecret — you will need these for OAuth authentication.

---

Request Parameters

This is a GET request with no request body. Pass the merchantId as a path parameter in the URL.

---

Response Parameters

itemsArray

List of application clients associated with the merchant.

Example: (See below)

codeString

"SUCCESS" if the call succeeded. Otherwise returns an error code object. See Appendix 1: Error Codes.

Example: "SUCCESS"

metaObject

Pagination metadata.

Example: {"count": 1}

---

Application object (items):

clientIdString

Unique client identifier for the application.

Example: "1647502414730379278"

clientSecretString

Client secret. Keep this confidential.

Example: "dtbDsFgbLDzGhMleKjTFZXGxrDKFnMqe"

client.publicKeyString

Application's public key.

Example: (PEM format)

server.publicKeyString

RM's server public key.

Example: (PEM format)

server.privateKeyString

RM's server private key (for reference only).

Example: (PEM format)

nameString

Application name.

Example: "required name"

homePageUrlString

Homepage URL.

Example: "https://google.com"

logoUrlString

Logo URL.

Example: "https://storage.googleapis.com/rm-sandbox-asset/img/default-application-logo.png"

privacyPolicyUrlString

Privacy policy URL.

Example: "https://google.com"

merchantIdString

Merchant ID this application belongs to.

Example: "1647501978894816174"

userIdString

User ID who created this application.

Example: "1647501978916382207"

oAuthClientProductsArray

OAuth client products.

Example: []

isActiveBool

Whether the application is active.

Example: false

redirectUriArray[String]

Allowed redirect URIs.

Example: ["https://google.com"]

createdAtDateTime

Creation date time of the application.

Example: "2022-03-17T07:33:34Z"

updatedAtDateTime

Last update date time of the application.

Example: "2022-03-17T07:36:10Z"