Standard Headers
Use these request headers to create API calls. Some calls may override the headers. These fields are generated when you register in the Partner Center. Most API calls require the headers on this page. If a call requires a different or additional header, it will be documented with that specific call.
Header | Required | Type | Description |
---|---|---|---|
App-Id | Yes | String | The app ID assigned to your platform in the Partner Center. |
App-Token | Yes | String | The app token generated in the Partner Center. |
Api-Version | Yes | String | The API version your platform is using. |
Content-Type | Yes | String | application/json |
Unique-Key | No* | String | This value allows your platform to safely retry requests and prevent processing the same request twice. Note: While this header is optional for most calls, the POST /payments and POST /refunds calls require a unique key. |
User-Agent | No* | String | The software agent acting on behalf of a user. Note: If your platform is using the SDKs, or a tool like Postman to send requests, user agents are implicitly sent. However, you must provide a user agent in cases where user agent isn't implicitly sent. |
Client-IP | No* | String | The original IP address of the end-user triggering the assocaited WePay API call from your UI. Note: This is only required when the WePay JS is not being used to tokenize sensitive information. See our guide on API Headers and our Risk Certification for more information. |
WePay-Risk-Token | No* | String | The Risk Token returned from the WePay JS when the JS is not being used for tokenization. Note: This is only required when the WePay JS is not being used to tokenize sensitive information. See our guide on API Headers and our Risk Certification for more information. |
Example
curl -X (Method) \
(Path) \
-H "App-Id: 121212" \
-H "App-Token: prod_MTAwXzk5OWIwZT666LWYwNWItNDU4MS1iZjBiL" \
-H "Api-Version: 3.0" \
-H "Content-Type: application/json" \
-H "Unique-Key: 5d92af09-82d1-4e55-9337-163114d03c13" \
-H "Client-IP: 100.166.99.123" \
-H "WePay-Risk-Token: 123e4567-e89b-12d3-a456-426655440000" \