Beispiel für Stripe Connector for Salesforce Platform AgnosticInvocable
Dieser Leitfaden enthält umsetzbare Code-Beispiele, die Schritt für Schritt zeigen, wie Stripe-Kundinnen und -Kunden und PaymentIntents direkt in Salesforce erstellt werden können. Wenn Sie ein Salesforce-Administrator oder eine/e Entwickler/in sind oder einfach Stripe und Salesforce verbinden möchten, um einen reibungslosen Datenfluss und eine reibungslose Transaktionsabwicklung zu gewährleisten, sind Sie hier genau richtig.
Bei den hier aufgeführten Beispielen werden nutzerdefinierte Apex-Klassen genutzt, um generische, agnostische Aufrufe der RESTful API von Stripe zu ermöglichen. Diese Beispiele sind praktisch, wenn Sie eine Abstraktionsebene zwischen Ihrer Salesforce-Plattform und der Stripe-API erstellen möchten, um Ihr System flexibler und einfacher zu verwalten.
Einen Kunden/eine Kundin in Stripe erstellen
Mit dem folgenden Codebeispiel wird ein/e Stripe-Kundin/Kunde erstellt, für den/die ein name
, eine email
und metadata
festgelegt sind.
// Step 1: Create an instance of the stripeGC.RawInvocableParameters class. This class is used to set the parameters for the Stripe API call. stripeGC.RawInvocableParameters parameters = new stripeGC.RawInvocableParameters(); // Step 2: Set the HTTP method to 'POST' as you are creating a new customer. parameters.method = 'POST'; // Step 3: Set the endpoint to '/v1/customers'. This is the Stripe API endpoint for creating a new customer. parameters.endpoint = '/v1/customers'; //Step 4: Set the Stripe Account ID from Salesforce and set it to the accountId field of the parameters object. parameters.accountId = 'a028B0000029RhlQAE'; //Step 5: Set the request body with the customer details. List<String> postCustomerParameters = new List<String>{ 'email=' + 'customerEmail@example.com', 'name=' + 'Tim Smith', 'metadata[AccountId]=' + 'abc123' }; parameters.requestBody = String.join(postCustomerParameters, '&'); //Step 6: Add the parameters object to a list and call the callStripeEndpoint method of the stripeGC.AgnosticInvocable class. List<stripeGC.RawInvocableParameters> paramsCollection = new List<stripeGC.RawInvocableParameters>{ parameters }; List<String> results = stripeGC.AgnosticInvocable.callStripeEndpoint(paramsCollection); //Step 7: The callStripeEndpoint method will return a list of strings. If the customer was created successfully, the first string in the list will be the ID of the new customer. System.debug(results[0]);
Einen PaymentIntent erstellen
Mit diesem Codebeispiel wird ein paymentIntent in Stripe erstellt.
public class stripePayment { @AuraEnabled(cacheable=true) public static String paymentIntent(String StripeAccountID, String amount, String stripecurrency, String orderID, String onBehalfOf, String customerId) { // Create Call for invocable stripeGC.RawInvocableParameters parameters = new stripeGC.RawInvocableParameters(); // Add HTTP Method parameters.method = 'POST'; // Add endpoint parameters.endpoint = '/v1/payment_intents'; // Get the Stripe Account ID from Salesforce // This assumes you already have the Stripe Account ID and will pass it in as a parameter // Alternately, you could use a SOQL query to obtain the Stripe Account ID as per previous examples parameters.accountId = StripeAccountID; parameters.connectAccount = onBehalfOf; // Prepare the request body List<String> postPaymentIntentParameters = new List<String>{ 'amount=' + amount, // Pass in the amount to be charged for this payment intent in the minimum currency unit (for example, cents for USD) 'currency=' + stripecurrency, // Pass in the currency for this payment intent (for example, 'usd' for USD) 'customer=' + customerId, // Pass in customer to payment intent 'automatic_payment_methods[enabled]=true', //Turning on automatic payment methods 'metadata[order_id]=' + orderID }; parameters.requestBody = String.join(postPaymentIntentParameters, '&'); List<stripeGC.RawInvocableParameters> paramsCollection = new List<stripeGC.RawInvocableParameters>{ parameters }; List<String> results = stripeGC.AgnosticInvocable.callStripeEndpoint(paramsCollection); return (results != null && results.size() > 0) ? results[0] : null; } }