Adds PayPal country property to the PaymentMethods and Charge objects
What’s new
Adds the country property for PayPal to the Payment Methods and Charge resources:
- For Payment Methods, in the paypal hash.
- For Charges, in the payment_method_details.paypal hash.
Impact
The country property represents the buyer’s country, which PayPal provides (if supported) at the time of authorization or settlement. You can’t set or mutate it. With this change, you can now retrieve the country value from either:
- A customer’s PayPal PaymentMethod
- A transaction paid using PayPal
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| country | Added | Charge. payment_method_details. paypal ConfirmationToken. payment_method_preview. paypal PaymentMethod. paypal |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-01-27. acacia
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.