Skip to main content
Comprehensive testing ensures your integration handles all scenarios correctly. Use this checklist and test scenarios to validate your implementation before going live.

​
Integration checklist

Before you launch your integration, verify that your implementation handles all critical scenarios correctly. This checklist covers the essential functionality, error states, and edge cases that ensure a robust commerce experience. Work through each item systematically to confirm your integration can handle real-world usage patterns and recover gracefully from common issues.

​
Basic functionality

  • Can create cart with simple items
  • Can handle PayPal payment (smart wallet)
  • Can handle successful payment return
  • Can complete checkout and get order confirmation
  • Can handle payment cancellation

​
Cart updates

  • Can update shipping address via PUT
  • Can add/remove items via PUT
  • Can apply and remove coupon codes
  • Can handle cart validation errors
  • Can update checkout field values

​
Error handling

  • Out of stock items are handled gracefully
  • Invalid addresses are caught and corrected
  • Network errors don’t break the flow
  • Payment failures are handled properly

​
Test scenario: Happy path

# 1. Create cart
POST /api/paypal/v1/merchant-cart
{
  "items": [
    {
      "variant_id": "TEST-PRODUCT-001",
      "quantity": 1,
      "price": {"currency_code": "USD", "value": "29.99"}
    }
  ],
  "payment_method": {
    "type": "paypal"
  }
}

# 2. Update with shipping
PUT /api/paypal/v1/merchant-cart/CART-TEST-123
{
  "items": [
    {
      "variant_id": "TEST-PRODUCT-001",
      "quantity": 1,
      "price": {"currency_code": "USD", "value": "29.99"}
    }
  ],
  "shipping_address": {
    "address_line_1": "123 Test Street",
    "admin_area_2": "Test City",
    "admin_area_1": "CA",
    "postal_code": "95131",
    "country_code": "US"
  },
  "payment_method": {
    "type": "paypal"
  }
}

# 3. Simulate PayPal return
POST /api/paypal/v1/merchant-cart/CART-TEST-123/checkout
{
  "payment_method": {
    "type": "paypal",
    "token": "EC-TEST123",
    "payer_id": "TEST_PAYER"
  }
}