View UPS Services

UPS Chargeback Protection Virtual Sandbox

Verify and score order risk for chargeback protection.

The UPS Chargeback Protection API allows developers to verify order details and receive risk scores to mitigate chargeback fraud. It provides a secure interface for integrating UPS commerce guard services into checkout workflows to validate transactions before fulfillment.

Use this hosted sandbox to simulate UPS Chargeback Protection 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 order risk assessment payloads, test score-based decision logic, simulate fraud detection responses, and verify integration with commerce guard verification endpoints.

UPS Chargeback Protection virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate UPS Chargeback Protection responses instantly.

https://ups-chargeback-protection.mock.beeceptor.com



Commerce Guard

Header NameExample
partnerId*"PARTNER_001"
transSrc"webstore"
transId"trans-001-a1b2c3"
Request Payload
{
  "userInformation": {
    "email": "alice.smith@example.com",
    "ipAddress": "192.168.1.101"
  },
  "billingContact": {
    "name": {
      "firstName": "Alice",
      "lastName": "Smith"
    },
    "phone": {
      "countryCode": "1",
      "number": "3125556789"
    },
    "address": {
      "addressLine": [
        "456 Elm Street",
        "Unit 12B"
      ],
      "city": "Chicago",
      "stateProvinceCode": "IL",
      "postalCode": "60616",
      "countryCode": "US"
    }
  },
  "shippingContact": {
    "name": {
      "firstName": "Alice",
      "lastName": "Smith"
    },
    "phone": {
      "countryCode": "1",
      "number": "3125556789"
    },
    "address": {
      "addressLine": [
        "456 Elm Street",
        "Unit 12B"
      ],
      "city": "Chicago",
      "stateProvinceCode": "IL",
      "postalCode": "60616",
      "countryCode": "US"
    }
  },
  "paymentInformation": {
    "txnId": "TXN20250716001",
    "method": "card",
    "issuerIdNumber": 411111,
    "lastDigits": 4242,
    "issuer": "Visa"
  },
  "products": [
    {
      "sku": "ROD-ABC-123",
      "name": "Wireless Bluetooth Headphones"
    }
  ],
  "orderValue": 199.99,
  "currencyCode": "USD",
  "orderId": "ORDER1001",
  "orderCreatedAt": "2025-07-16T10:53:11.893Z"
}
Response Payload
{
  "superScore": 500,
  "decision": "review",
  "categoryScores": {
    "addressReliabilityScore": {
      "score": 520,
      "rank": "medium"
    },
    "digitalIdentityScore": {
      "score": 999,
      "rank": "high"
    },
    "proxyScore": {
      "score": 0,
      "rank": "no_risk"
    },
    "paymentReliabilityScore": {
      "score": 140,
      "rank": "low"
    }
  }
}
{
  "response": {
    "errors": [
      {
        "code": "MISSING_FIELD",
        "message": "shippingContact.address.postalCode is required"
      }
    ]
  }
}
{
  "response": {
    "errors": [
      {
        "code": "UNAUTHORIZED",
        "message": "Invalid credentials"
      }
    ]
  }
}
{
  "response": {
    "errors": [
      {
        "code": "UNSUPPORTED",
        "message": "Merchant does not have permission for this product"
      }
    ]
  }
}
{
  "response": {
    "errors": [
      {
        "code": "DEPENDENCY_VALIDATION_FAILED",
        "message": "Invalid IP address format"
      }
    ]
  }
}
{
  "response": {
    "errors": [
      {
        "code": "SERVER_ERROR",
        "message": "system Unexpected exception while processing the request"
      }
    ]
  }
}
Service Homepage: github.com/UPS-API/api-documentation/blob/main/CommerceGuard.yaml
upslogisticsfraudcommercepayments