Connect Stripe or Mercado Pago

Before a conversational form can charge anyone, Tayon needs your gateway’s keys. A payment connection is where they live. You enter them once, they are encrypted, and from then on your flows refer to the connection by name.

Configuration›Payment Connections

The screen says it plainly: “Connect Stripe or Mercado Pago so your conversational flows can take payments. Your keys are encrypted and are never shown again once saved.”

#Create a connection

Stripe asks for a Secret key, a Publishable key and a Webhook signing secret. Mercado Pago asks for an Access token, a Public key and a Webhook signing secret. The webhook secret is the one you cannot have yet — see below.

Default currency is optional. Each payment step in a flow sets its own currency anyway.

#Your keys are gone as soon as you save them

That is also why an empty credential box when you Edit means keep what is there, not clear it. Type in a box only when you actually want to replace that key.

If a connection is badged Insecure — re-enter credentials, its keys were stored before encryption was in place. Open it and paste them in again.

#Register the webhook

The webhook is how Tayon finds out a payment really succeeded, rather than guessing from the buyer’s browser. Without it, card payments still resolve but PIX and boleto orders sit at Awaiting payment forever.

Regenerate webhook URL exists for the case where the address has leaked.

#Test it before you sell anything

Test connection asks the gateway whether the keys work, and tells you which it is:

A connection that has never been tested shows Never verified. Test it before you publish a flow that depends on it.

#The badges on the list

#Defaults

There is one default per gateway. The first connection you create for a gateway becomes the default whether or not you ticked the box, so a flow set to Account default always has something to resolve to.

You cannot untick the only default — you move it, by setting a different connection as default instead. Deleting the default promotes the oldest remaining connection.

#Edit, Deactivate, Delete

Deleting a connection that orders refer to warns you how many, and makes you confirm.

#Your keys never enter a flow

A payment step in the Flow Designer stores a reference to a connection — never a key. That means you can duplicate a flow, hand it to a colleague, or export it, and no credential goes with it. Change a key here and every flow using the connection picks it up with no edits.

#Next

• Take a payment inside your site
• See the payments you have taken