Stripe Integration Notes

[michaelbromley]

This is a place for community members who are implementing Stripe integrations to share notes.

To do:

• Prior art - list of existing stripe plugins on GitHub
• Common issues, e.g. how to handle parsing of raw body & stripe signature
• Workflows - do custom order states need to be defined?

[tzdigital]

For my part, I see 2 use cases for the "one time" payment:

• 3D Secure is required
• 3D Secure is not required

I would like to discuss with you the best way to do it

I added a CustomOrderProcess & a CustomPaymentProcess to add the 3DS confirmation step in the event that it will be requested, but I have the impression that this is not enough, I put it maybe wrong, or I do understand not well the system

const customPaymentProcess: CustomPaymentProcess<"Processing"> = {
  transitions: {
    Created: {
      to: ["Processing"],
      mergeStrategy: "replace",
    },
    Processing: {
      to: ["Settled", "Declined", "Cancelled"],
    },
  },
};


const customOrderProcess: CustomOrderProcess<"ProcessingPayment"> = {
  transitions: {
    ArrangingPayment: {
      to: ["ProcessingPayment"],
      mergeStrategy: "replace",
    },
    ProcessingPayment: {
      to: ["PaymentAuthorized", "PaymentSettled", "ArrangingAdditionalPayment"],
    },
  },
};

Payment Handler :

 
  intent = await gateway.paymentIntents.create({
    amount: amount,
    currency: "EUR",
  });


  // if 3D SECURE is required
  if (three_d_secure_required) {
    return {
      amount: amount,
      state: "Processing" as any,
      transactionId: intent.id,
      metadata: {
        intent,
        public: {
          secretKey: intent.client_secret,
        },
      },
    };
  }

  return {
    amount: amount,
    state: "Settled" as any,
    transactionId: intent.id,
    metadata: {
      intent,
      public: {
        secretKey: intent.client_secret,
      },
    },
  };

and the orderPlacedStrategy

class MyOrderPlacedStrategy implements OrderPlacedStrategy {
  shouldSetAsPlaced(
    ctx: RequestContext,
    fromState: OrderState,
    toState: OrderState
  ): boolean | Promise<boolean> {
    return (
      fromState === ("ProcessingPayment" as any) &&
      toState === ("PaymentSettled" as any)
    );
  }
}

thx for help 🙌