Skip to main content
POST
Connect an Adyen merchant account

Authorizations

Authorization
string
header
required

Portal API key minted in portal Settings → API access. Scope read or write; pinned to one company. Send as Authorization: Bearer lac_sk_....

Body

application/json
merchant_account
string
required

The merchant account code exactly as Adyen Customer Area shows it.

Pattern: ^[A-Za-z0-9][A-Za-z0-9_.-]{0,79}$
api_key
string
required
write-only

The Report user's API key. Never returned.

customer_id
string

Target company. Optional for API keys.

Response

The key is stored and the connection is registered. A verified key starts the first import; a refused or unchecked one leaves the connection waiting for a recheck. The response carries only the key's last four characters.

customer_id
string
required
connection
object
required

A connection created from a pasted credential. A connection waiting for verification has status reauth_required, attention_required and reauth_required true, last_error_code credential_rejected (the provider refused the credential) or credential_unverified (the provider could not be reached), the provider's message in last_error_message, and no external_company_id until a recheck verifies it.

event_id
string
required
credential_check
object
required

The last check of a stored credential with its provider. rejected: the provider refused it; unverified: the provider could not be reached to check it; not_checked: the provider offers no check. Absent on connections that predate credential checks.