PayPal授权、部分金额捕获及剩余金额作废的技术咨询

Hey there, let's walk through the compliant workflow and critical considerations for your partial order cancellation scenario with PayPal, building on the steps you've already completed:

You've already nailed the first two key steps, so let's confirm those and cover the final required action:

• Step 1: Initial Authorization (Completed)
  Your call to the Payments API with intent=authorize for $300 was the right move—this correctly freezes the specified amount in the buyer's PayPal account without initiating an immediate charge, which aligns with PayPal's authorization rules for order holds.
• Step 2: Partial Capture (Completed)
  Capturing $200 (less than the full authorized amount) is fully compliant. This action charges the buyer for the retained portion of their order and reduces the remaining authorized balance to $100.
• Step 3: Void Remaining Authorization (Required)
  To complete the workflow properly, you need to call the PayPal Authorization Void API using the original authorization ID from Step 1. This will release the remaining $100 hold back to the buyer's account, formally canceling the unused portion of their authorization.

Don't overlook these details to stay aligned with PayPal's policies and avoid buyer disputes:

• Authorization Time Limits: PayPal authorizations expire after 29 days. You must complete all captures and void actions within this window—after expiration, the held funds are automatically released, and you'll lose the ability to capture any remaining amount.
• Capture Restrictions: A single authorization can support one full capture or multiple partial captures, but the total captured amount can never exceed the original authorized amount. Since you've only captured $200, voiding the rest is the only valid next step (you can't capture additional funds later unless you create a new authorization).
• Timely Voiding: Always void unused authorization balances as soon as the order cancellation is confirmed. Delaying this can lead to buyer frustration if they see a lingering hold on their account, and may trigger PayPal policy flags if funds are held unnecessarily.
• Buyer Communication: Send a clear notification to the buyer confirming:
  • The partial capture of $200 for the retained order items
  • The void of the remaining $100 authorization
  • The reason for the partial cancellation (XYZ, as you noted)
    Transparency here prevents chargebacks and builds trust.
• Record-Keeping: Save all API request/response logs, including authorization IDs, capture IDs, and void confirmation details. These records are critical for resolving disputes, reconciling accounts, and demonstrating compliance if PayPal audits your transactions.
• API Validation: Ensure you're using the correct authorization ID when calling the void endpoint—mixing up IDs can lead to unintended actions (like voiding a valid, active authorization). Double-check that the void response confirms the remaining balance was released successfully.

内容的提问来源于stack exchange，提问作者Mit Makwana