Initiate Stripe Connect OAuth

Start the Stripe Connect OAuth flow for a processor. Returns a URL that the merchant must visit in their browser to authorize their Stripe account.

Flow:

1. Call this endpoint with the processorId of a Stripe-type processor
2. Redirect the merchant to the returned url
3. After authorization, Stripe redirects back to TagadaPay which saves the connected account credentials
4. The processor is now ready to accept payments via Stripe Connect

POST /api/public/v1/processors/stripe-connect/initiate

Initiate Stripe Connect OAuth

cURL

curl --request POST \
  --url https://api.tagada.io/api/public/v1/processors/stripe-connect/initiate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "processorId": "processor_abc123"
}
'

200

{
  "url": "https://connect.stripe.com/oauth/authorize?response_type=code&client_id=ca_...&scope=read_write&state=..."
}

Authorizations

Authorization · string · header · required

Enter your API key as: Bearer your-api-key

Body

application/json

processorId · string · required

returnUrl · string

isFromOnboarding · boolean · default: false

redirectUrl · string

Response

200

application/json

Successful response