View UPS Services

UPS PIN Management System Virtual Sandbox

Secure package delivery verification via protected tokens and PIN management.

The PIN Management System API provides a secure framework for Verified Delivery. It allows shippers to generate and manage secure PINs required to release packages to intended recipients, ensuring an extra layer of security for high-value or sensitive shipments.

Use this hosted sandbox to simulate UPS PIN Management System APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready. This keeps your integration code consistent across local development, QA, demos, and production.

Use cases:

Use this sandbox to validate PIN generation workflows, token retrieval processes, and EPRA status checks. Developers can simulate successful PIN issuance, handle invalid token requests, and test the integration logic required to trigger secure delivery notifications for end-customers.

UPS PIN Management System virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate UPS PIN Management System responses instantly.

https://ups-pin-management.mock.beeceptor.com



Protected Delivery Token(4 operations)

Header NameExample
transID*"sunt proident"
transactionSrc*"dolore laboris quis reprehenderit"
Request Payload
{
  "pin": "123456"
}
Response Payload
{
  "token": "550e8400-e29b-41d4-a716-446655440000"
}
{
  "errors": [
    {
      "code": "50001",
      "message": "Pin is required for request"
    }
  ]
}
{
  "errors": [
    {
      "code": "250002",
      "message": "Invalid Authentication Information"
    }
  ]
}
{
  "errors": [
    {
      "code": "40301",
      "message": "You do not have permission to access this resource."
    }
  ]
}
{
  "errors": [
    {
      "code": "40401",
      "message": "The specified resource was not found."
    }
  ]
}
{
  "errors": [
    {
      "code": "41501",
      "message": "The server cannot process the request because the payload format is not supported."
    }
  ]
}
{
  "errors": [
    {
      "code": "42901",
      "message": "You have sent too many requests in a short period. Please try again later."
    }
  ]
}
{
  "errors": [
    {
      "code": "10067",
      "message": "Internal Server Error"
    }
  ]
}
Header NameExample
X-UserToken*"94203314-c4a1-8bd1-1ac0-a3fab5a460fd"
transID*"quis pariatur ut"
transactionSrc*"commodo exercitation"
Request Payload
Response Payload
{
  "pin": "123456"
}
{
  "errors": [
    {
      "code": "50001",
      "message": "Token is required for request"
    }
  ]
}
{
  "errors": [
    {
      "code": "250002",
      "message": "Invalid Authentication Information"
    }
  ]
}
{
  "errors": [
    {
      "code": "40301",
      "message": "You do not have permission to access this resource."
    }
  ]
}
{
  "errors": [
    {
      "code": "40401",
      "message": "The specified resource was not found."
    }
  ]
}
{
  "errors": [
    {
      "code": "42901",
      "message": "You have sent too many requests in a short period. Please try again later."
    }
  ]
}
{
  "errors": [
    {
      "code": "10067",
      "message": "Internal Server Error"
    }
  ]
}
Header NameExample
transID*"et amet eiusmod velit consectetur"
transactionSrc*"tempor dolore minim"
Request Payload
{
  "trackingNumbers": [
    "1Z999AA10123456784",
    "1Z999AA10123456785",
    "1Z999AA10123456786"
  ]
}
Response Payload
{
  "results": [
    {
      "trackingNumber": "1Z999AA10123456784",
      "pin": "123456"
    },
    {
      "trackingNumber": "1Z999AA10123456785",
      "pin": "005678"
    }
  ]
}
{
  "errors": [
    {
      "code": "50001",
      "message": "Tracking Numbers are required for request"
    }
  ]
}
{
  "errors": [
    {
      "code": "250002",
      "message": "Invalid Authentication Information"
    }
  ]
}
{
  "errors": [
    {
      "code": "40301",
      "message": "You do not have permission to access this resource."
    }
  ]
}
{
  "errors": [
    {
      "code": "40401",
      "message": "The specified resource was not found."
    }
  ]
}
{
  "errors": [
    {
      "code": "41501",
      "message": "The server cannot process the request because the payload format is not supported."
    }
  ]
}
{
  "errors": [
    {
      "code": "42901",
      "message": "You have sent too many requests in a short period. Please try again later."
    }
  ]
}
{
  "errors": [
    {
      "code": "10067",
      "message": "Internal Server Error"
    }
  ]
}
Query Parameter NameExample
actionexercitation
Header NameExample
trackingNumber*"nostrud"
epra"Ut"
Authorization*"ea amet dolore"
transID*"in"
transactionSrc*"laborum dolor nulla"
Request Payload
Response Payload
{
  "response": {
    "epraCode": "EPRA123",
    "epraRequired": "Yes",
    "epraMatch": "No",
    "epraKiala": "N/A"
  }
}
{
  "errors": [
    {
      "code": "10013",
      "message": "Missing required header(s) in request"
    }
  ]
}
{
  "errors": [
    {
      "code": "250002",
      "message": "Invalid Authentication Information"
    }
  ]
}
{
  "errors": [
    {
      "code": "40301",
      "message": "You do not have permission to access this resource."
    }
  ]
}
{
  "errors": [
    {
      "code": "40401",
      "message": "The specified resource was not found."
    }
  ]
}
{
  "errors": [
    {
      "code": "42901",
      "message": "You have sent too many requests in a short period. Please try again later."
    }
  ]
}
{
  "errors": [
    {
      "code": "90401",
      "message": "SQL exception experienced"
    }
  ]
}
{
  "errors": [
    {
      "code": "10068",
      "message": "The webservice is disabled"
    }
  ]
}
Service Homepage: github.com/UPS-API/api-documentation/blob/main/ProtectedDeliveryToken.yaml
upslogisticssecuritydeliverypinstokens