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

Confirm that you can complete the core commerce flows:
  • Create cart with simple items.
  • Handle PayPal payment (smart wallet).
  • Handle successful payment return.
  • Complete checkout, including order confirmation.
  • Handle payment cancellation.

​
Cart updates

Confirm that you can perform these cart operations:
  • Update shipping address using PUT.
  • Add and remove items using PUT.
  • Apply and remove coupon codes.
  • Handle cart validation errors.
  • Update checkout field values.

​
Error handling

Confirm that your integration handles errors gracefully:
  • Handle out-of-stock items.
  • Handle invalid addresses by catching and correcting them.
  • Ensure network errors don’t break the flow.
  • Handle payment failures 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"
  }
}