---
title: "Initiate payment processor connection"
method: POST
path: "/teams/{key}/payment/connect"
tags: ["Team Payments"]
---

# Initiate payment processor connection

`POST /teams/{key}/payment/connect`

Start the OAuth flow to connect a team's payment processor account. Returns an authorization URL to redirect the user to the payment provider's OAuth page. The OAuth callback is handled directly by the payment gateway.

## Path parameters

- `key` string, required — Team identifier (ID or slug)

## Request body

- object
  - `provider` 'STRIPE' | 'AIRWALLEX', required — Payment processor to connect

## Response `200`

OK

- object
  - `authorizationUrl` string, uri, required — URL to redirect the user to for OAuth authorization. Open in a new window or redirect the current page.

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `409` — 409
- `412` — 412
- `422` — 422
- `429` — 429
- `500` — 500
- `501` — 501
- `503` — 503

---

[API](https://skmtc.net/session/apis/session-services-api.md) · [All operations](https://skmtc.net/session/apis/session-services-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/session/session-services-api/revisions/b7e11f398fe0/schema)
