Why Is My Apex Method Not Receiving Stripe Webhook Data?

Below is some guidance on troubleshooting your setup:

1. Confirm Your HTTP Request Contains a Body

Your code to read the request body is correct. The error

  System.NullPointerException: Attempt to de-reference a null object

usually means that RestContext.request or its requestBody is null. This can happen when:
 • The endpoint is called using a GET or another HTTP verb that does not include a body.
 • Your test tool (or Stripe) is not sending any data in the POST body.

Make sure that you send a valid non-null payload as a POST request. For example, try using cURL to simulate a POST with a JSON body:

BASHCopied
curl -X POST https://yourInstance.my.salesforce-sites.com/services/apexrest/stripeWebhook/ \
  -H "Content-Type: application/json" \
  -d '{"id": "evt_1...", "object": "event", "type": "card.created", "data": { "object": {...} } }'

2. Verify Endpoint Accessibility

If you are testing locally or using a tool like Postman, confirm that the URL mapping is accessible (for example, via a Force.com Site or through a publicly accessible domain). Stripe’s webhook must be able to reach your Salesforce REST endpoint.

3. Check Your Configuration in Stripe

Ensure that your webhook endpoint on Stripe’s Dashboard is configured with the correct URL, and that Stripe is indeed sending the POST request with a JSON payload when the event (i.e. card creation) happens.

4. Additional Steps

• Logging: Continue using System.debug to check if any request data is received.
• Custom Exception Handling: Consider adding null checks around RestContext.request.requestBody to prevent immediate NullPointerExceptions while you troubleshoot.

For example, you could update your method as follows during debugging:

APEXCopied
@HttpPost
global static String handleWebhook() {
    if (RestContext.request == null || RestContext.request.requestBody == null) {
        System.debug('No request or request body received.');
        return 'error';
    }
    String requestBody = RestContext.request.requestBody.toString();
    System.debug('=== requestBody ===');
    System.debug(requestBody);
    return 'success';
}

This protects against the null reference and gives you a better idea of when and why the POST body might be missing.

Summary

• Your Apex code for reading the payload is correct.
• The error indicates that the POST request isn’t sending any data (or isn’t reaching your code as expected).
• Ensure that your endpoint is publicly accessible and that you are testing with a POST that includes a non-null body.
• Verify your Stripe webhook configuration so that it sends a proper payload to your Salesforce endpoint.

Following these steps should help you to capture and process Stripe’s event data in your Apex method.