v1

latestOpenAPI 3.0.02026-07-26167441.9 MB

Create a Connection

Creates a connection in ACTIVE status.

post/connections

Headers

X-Idempotency-Keystring uuid required

Request body

account_idstring uuid required

merchant_connection_idstring required

provider_idstring required

flow_typestring required

payment_methodsstring[] required

Example request

{
  "account_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "merchant_connection_id": "adyen-us-prod-001",
  "provider_id": "ADYEN",
  "flow_type": "PAYIN",
  "payment_methods": [
    "CARD",
    "GOOGLE_PAY"
  ]
}

Response

Created

connection_idstring

merchant_connection_idstring

provider_idstring

statusstring

flow_typestring

payment_methodsstring[]

paramsobject[]

costsobject[]

created_atstring date-time

updated_atstring date-time

Example response

{
  "connection_id": "f1a3c4d5-7b8e-4a2c-9d1e-3f4a5b6c7d8e",
  "merchant_connection_id": "stripe-us-prod-001",
  "provider_id": "STRIPE",
  "status": "ACTIVE",
  "flow_type": "PAYIN",
  "payment_methods": [
    "CARD",
    "GOOGLE_PAY",
    "APPLE_PAY"
  ],
  "created_at": "2026-05-12T10:24:00Z",
  "updated_at": "2026-05-12T10:24:00Z"
}