In this section, we explain how to establish connectivity and provide details
on the API design patterns and security model.
API communication details
Communication with the One Time Payment Code API involves transport layer and
application layer security. The transport layer
uses TLS to secure HTTP requests (HTTPS) and the
application layer uses
either PGP or
JWE encryption.
In addition, our Protocol standards to find details on
our API design patterns and strategy for maintaining a robust connection with
partners.
Key exchanges
Encryption keys need to be rotated before they expire or if they are
compromised. As part of your implementation, you need to have a process for
managing these exchanges.
To ensure key rotations do not cause temporary outages or require significant
management overhead, One Time Payment Code partners must support the use
of multiple encryption keys at once. During a key rotation, a second key will
be trusted and verified to be working correctly before the old key is removed.
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-12-03 UTC.
[null,null,["Last updated 2024-12-03 UTC."],[[["This section outlines how to establish a secure connection with the One Time Payment Code API, covering transport and application layer security using TLS and either PGP or JWE encryption respectively."],["It provides guidance on API design patterns and maintaining robust connections through documented protocol standards."],["Encryption key rotation is crucial for security, and partners must implement a process to manage these exchanges and support the use of multiple keys concurrently to prevent service disruptions."],["Failure to support multiple encryption keys during rotation is a critical issue that must be addressed before launch."]]],["The API uses TLS for transport layer security (HTTPS) and PGP or JWE for application layer security. Partners must adhere to protocol standards for API design patterns and robust connections. Encryption key rotation is mandatory, requiring support for multiple active keys simultaneously to prevent outages. A second key must be verified before the old key is removed; failing this verification is a launch-blocking issue.\n"]]