Skip to main content
Complete the following prerequisites and configuration to start using the Prove Connector.

Prerequisites

Before you begin, make sure you meet the following requirements:
  • You have completed the steps in the Getting started.
  • You have an active contract with Prove and have configured your accounts and credentials for Prove.

Configuration

To configure your connector, follow these steps:
  1. Set your APIM subscription key in the header as follows:
    • Key: api-key
    • Value: <your subscription key>
  2. Request the Grand Central team to set up a connection with Prove, and provide the following details for OAuth token generation:
    • prove-grant-type
    • prove-password
    • prove-username
  3. Configure the Prove baseURL in the gc-applications-live repository in the connector’s values.yaml file:
prove.baseUrl= //PROVE environment base URL
  1. The following example shows the connector’s values.yaml file location:
├── iPaaS
└── azure/runtimes
    ├── dev
    └── test
        └── values
            ├── gc-prove
              └── party-lifecycle-v0.values.yaml
              └── party-v0.values.yaml
              └── party-v2.values.yaml

Test your integration

To access the Party Reference Unified API, include your Grand Central subscription key in the request header. If you don’t have a key, contact the Grand Central Support Team to have one provisioned.
KeyValue
api-key<your_subscription_key>
Test the API using the Postman Collection.

Troubleshooting

If your connector isn’t responding as expected, check these common scenarios.
Cause: The Grand Central gateway can’t establish a handshake with the Prove endpoint. This typically indicates an upstream service outage at Prove or a network routing failure.Solution: Verify the operational status of the Prove environment with Prove. If the service is operational, contact the Grand Central team team.
Cause: The request to Prove exceeded the configured timeout threshold. This can occur during high load or network latency issues.Solution: Verify the operational status of the Prove environment with Prove. If the service is operational, contact the GC Support team to review timeout configurations.
Cause: The credentials provided during setup are incorrect.Solution: Verify your credentials with Prove and contact the GC team to update the connection.
Cause: The number of incoming requests exceeded the defined threshold for your subscription tier. This response protects the stability of the Grand Central and partner infrastructure.Solution: Review your application’s request patterns to identify unexpected spikes. If you require higher throughput, contact the Grand Central team to request an adjustment to your APIM rate limit policy.

Need more help?

Contact support

Reach out to the Grand Central team for assistance with environment setup or rate limit increases.