Skip to main content
Follow the steps in Get started with connectors before proceeding. SurePay access: An active contract with SurePay, with accounts and credentials for SurePay services.

​
Prepare the connector

Backbase deploys this connector. To provide the environment details, follow these steps:
  1. Send environment details to Backbase. Send surepay-grant-type, surepay-vop-authorization for Verification of Payee, surepay-cop-authorization for Confirmation of Payee, and the SurePay base URLs to your Backbase support team.
    The authorization values for Verification of Payee and Confirmation of Payee are different.
For property names and defaults, see Reference.

​
Test your integration

To access the Party Reference Unified API, include your Banking OS subscription key in the request header. If you do not have a key, contact your Backbase support team to have one provisioned. Test the API using the Postman collection.

​
Troubleshooting

If your connector is not responding as expected, check these common scenarios.
Cause: The Banking OS gateway cannot establish a handshake with the SurePay endpoint. This typically indicates an upstream service outage at SurePay or a network routing failure.Solution: Verify the operational status of the SurePay environment with SurePay.
Cause: The request to SurePay exceeded the configured timeout threshold. This can occur during high load or network latency issues.Solution: Verify the operational status of the SurePay environment with SurePay.
Cause: The credentials provided during setup are incorrect.Solution: Verify your credentials with SurePay 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 Banking OS and partner infrastructure.Solution: Review your application’s request patterns to identify unexpected spikes. If you require higher throughput, contact your Backbase support team to request an adjustment to your APIM rate limit policy.