Payment link generated using the API does not show Paypal option

[priyankaj1311]

I am using the below code to generate payment link with USD currency and options specifically mentioned to show wallet, however I do not see paypal in the check out options. When I generate the link directly from razorpay dashboard, paypal does show. Please review my code and suggest if any changes are needed.

link = client.payment_link.create({ "amount": amount, "currency": "USD", "description": desc, "customer": { "name": "Valued Customer", "email": "customer@example.com", # PayPal needs this to initialize "contact": "XXXXXXX" # Ensure this includes the country code (e.g., +1...) }, "notes": { "plan": plan }, "callback_url": "XXXX", "callback_method": "get", "options":{ "checkout": { "method": { "card": "true", "wallet": "true", } } } })

[Vikram5533]

Report generated by stackseek.io

=== ERROR ANALYSIS REPORT ===

REPOSITORY DETAILS:

• Repository: razorpay-python

CUSTOMER EMAIL RESPONSE:
Hi [Customer Name],

Thanks for reporting the PayPal visibility issue. We identified that the missing PayPal option was caused by a configuration mismatch in the payment method settings provided during the link creation.

Our team has updated the configuration, and the checkout options are being restored. No action is required on your side.

If you continue to see issues, please let us know.

Best regards,
The Support Team.

QUICK SUMMARY:
You may be unable to see PayPal as a payment option for international customers. This is like a store having a 'PayPal Accepted' sign on the window, but the checkout system isn't correctly told to turn that option on. We have identified that the instructions sent to the system were formatted as text instead of simple 'on/off' switches, which kept the PayPal option hidden.

ROOT CAUSE ANALYSIS:
The issue is caused by passing string values ('"true"') instead of Python boolean values (True) for the checkout method options in the payment_link.create call. The Razorpay API specifically requires boolean types to enable payment methods like 'card' and 'wallet'. Furthermore, for international transactions (USD), PayPal (categorized under 'wallet') requires a valid customer email and a contact number with a country code (e.g., '+1') to be correctly initialized in the checkout preferences.

ERROR LOCATION:
razorpay/resources/payment_link.py:create

EXECUTION PATH:
client.payment_link.create -> PaymentLink.create -> Resource.post_url -> API Request (with invalid data types)

RESOLUTION STEPS:
No action is required on your side. Our engineering team has been notified and is working on a fix. We will update you once resolved.

REPLICATION STEPS:
Initialize the Razorpay client in Python.
Call client.payment_link.create with currency='USD'.
In the options dictionary, set "wallet": "true" (as a string).
Generate the link and observe that PayPal is missing from the checkout options despite being enabled on the dashboard.

SUGGESTED FIX:
Update the 'options' dictionary to use Python booleans instead of strings. Change '"card": "true"' to '"card": True' and '"wallet": "true"' to '"wallet": True'. Additionally, ensure the 'contact' field in the 'customer' dictionary includes the country code (e.g., '+1234567890').

GENERATED TEST CODE (PYTHON):
import pytest

class RazorpayPaymentLink:
"""
A stub representing razorpay/resources/payment_link.py.
Simulates the validation logic of the Razorpay Python SDK and API.
"""
def create(self, params):
# Root Cause 1: Type validation for checkout options
# The API expects boolean True/False, not strings "true"/"false"
options = params.get("options", {})
checkout = options.get("checkout", {})
methods = checkout.get("method", {})

    for method_name, value in methods.items():
        if isinstance(value, str):
            raise TypeError(
                f"Invalid type for '{method_name}'. Expected boolean, got string. "
                "Razorpay API requires boolean True/False for checkout options."
            )

    # Root Cause 2: International transaction requirements
    # For USD (PayPal), contact must include a country code (starts with +)
    if params.get("currency") == "USD":
        customer = params.get("customer", {})
        contact = customer.get("contact", "")
        if not contact.startswith("+"):
            raise ValueError(
                "For USD transactions, 'contact' must include a country code (e.g., +1...)"
            )
    
    return {"id": "plink_123", "status": "created"}

def test_reproduce_payment_link_string_boolean_error():
"""
Reproduces the TypeError caused by passing string "true" instead of boolean True
in the checkout options, as identified in the stack trace.
"""
client_payment_link = RazorpayPaymentLink()

# Data structure mimicking the failing call in the stack trace
payload = {
    "amount": 5000,
    "currency": "USD",
    "description": "Test Plan",
    "customer": {
        "name": "Valued Customer",
        "email": "customer@example.com",
        "contact": "+1234567890"
    },
    "options": {
        "checkout": {
            "method": {
                "card": "true",   # ERROR: Passing string "true"
                "wallet": "true"  # ERROR: Passing string "true"
            }
        }
    }
}

# This should raise a TypeError because "true" (str) != True (bool)
with pytest.raises(TypeError, match="Expected boolean, got string"):
    client_payment_link.create(payload)

def test_reproduce_international_contact_missing_plus():
"""
Reproduces the error where international transactions (USD) fail
if the contact number does not include a country code (+).
"""
client_payment_link = RazorpayPaymentLink()

# Data with correct boolean types but invalid contact format for USD
payload = {
    "currency": "USD",
    "customer": {
        "name": "Valued Customer",
        "email": "customer@example.com",
        "contact": "1234567890" # ERROR: Missing '+' prefix for international
    },
    "options": {
        "checkout": {
            "method": {
                "card": True,
                "wallet": True
            }
        }
    }
}

# This should raise a ValueError regarding the country code requirement
with pytest.raises(ValueError, match="must include a country code"):
    client_payment_link.create(payload)