Connect your account
1
Create a restricted key
Open the API Keys page in Stripe and click Create restricted key. When Stripe asks how you will use the key, choose Providing this key to a third-party application.
2
Enter SellAuth's details
Enter
SellAuth as the name and sellauth.com as the URL. Leave Customize permissions for this key unchecked: the permissions Stripe selects for third-party applications cover everything SellAuth needs. Click Create key and confirm with two-factor verification.3
Copy the restricted key
It starts with
rk_live. Paste it into API Key on the SellAuth payment method page.4
Copy the publishable key
It starts with
pk_live and is on the same Stripe page. Paste it into Publishable Key. Required for the Inline and Embedded checkout forms, so only the Redirect form works without it.5
Save
The method is now live at checkout.
Choosing permissions yourself
If you check Customize permissions for this key, or edit the key later, keep at least these:
Without Payment Disputes and Files, disputes still arrive through Stripe’s webhooks, but SellAuth cannot submit evidence for you. Early fraud warnings have no permission of their own in Stripe’s list and also arrive through the webhook.
Options
Checkout form
Checkout Form decides where the buyer enters their payment details.
Inline and Embedded keep the buyer on your checkout, which also works better inside a checkout embed on your own site. Both need the publishable key.
Apple Pay and Google Pay
With Redirect and Embedded, the wallet buttons appear on Stripe’s own page and need no setup. With Inline, the buttons render on your own domains, and Stripe only shows them on domains registered with your Stripe account. SellAuth registers your SellAuth subdomain and your verified custom domain when you save the method, and again when a new custom domain verifies. The Wallets section of the payment method page lists each domain with its status, plus Retry registration if one did not go through. If the restricted key is missing Payment Method Domains: Write, SellAuth notifies you and the wallet buttons stay hidden until you add the permission and retry.Currency conversion
Shows the price in the buyer’s currency, taken from their IP address or from your storefront’s currency selector. This also makes local payment methods available, since several of them only work in their home currency. Allowed Currencies narrows which currencies conversion may use. Leave it empty to allow all of them, or restrict it if you only want to hold a few currencies in Stripe.Terms of service checkbox
Adds a terms checkbox to the Stripe checkout page, creating a record that the buyer accepted your terms at the time of payment, which is useful evidence in a dispute. Write the terms in the text box, or leave it empty and Stripe will use the terms URL from your Stripe public settings. Stripe does not support this checkbox on the Inline form, so the setting only applies to Redirect and Embedded.Billing address collection
Makes Stripe collect a billing address, which helps with fraud screening and tax records. This is Stripe’s own collection and is separate from the SellAuth Collect Billing Address setting in checkout settings.Automatic tax
Stripe calculates and charges tax based on the buyer’s location.Fees and limits
The shared method settings apply here as well. Stripe also supports currency override, which bills the invoice in a fixed currency of your choice rather than your shop currency. Use it when your Stripe account only settles in specific currencies, and use currency conversion when you want the buyer’s currency to decide.Troubleshooting
The method cannot be selected at checkout. The order total is outside the minimum or maximum amount set on the method. Hovering the method at checkout gives the reason. The buyer sees Stripe’s page instead of a form on yours. The checkout form is set to Redirect, or the publishable key is missing. Apple Pay or Google Pay never shows on the Inline form. Open the Wallets section on the payment method and check that every domain is ready. A domain marked not registered usually means the restricted key lacks Payment Method Domains: Write. Also check that the wallets are turned on in your Stripe dashboard’s payment method settings, and that you are testing on a device and browser that supports them. The terms of service checkbox never appears. The checkout form is set to Inline, which Stripe does not support it on. Switch to Redirect or Embedded if you need it. Tax is charged twice. Both Stripe automatic tax and SellAuth tax calculation are on. See above. A local method such as iDEAL never shows. It must be enabled in your Stripe dashboard, the currency must match, and the buyer must be in a supported country. An order sits at Confirming. The buyer used a method that does not settle at once, such as an ACH, SEPA or BACS bank debit, a bank transfer, or a voucher like Boleto, OXXO, Konbini or Multibanco. Check the payment in your Stripe dashboard and process the order once Stripe shows it as succeeded. See why an invoice is confirming.Next steps
Supported payment methods
Everything else you can enable.
Refunds and chargebacks
Recording a Stripe refund, and winning disputes.