Connect SDK

Appearance

@swapped/connect-sdk / wallet-verification / StartCoinbaseVerificationRequest

Type Alias: StartCoinbaseVerificationRequest ​

StartCoinbaseVerificationRequest = object

Defined in: src/types/wallet-verification.types.ts:643

Input for WalletVerificationCoinbase.startVerification. Creates method: 'exchange_oauth'. Does not open Coinbase by itself in new-tab mode.

Example ​

ts
await client.coinbase.startVerification({
  address: '0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B',
  network: 'evm',
  customerId: 'user-1234',
})
const verification = await client.coinbase.openVerificationTab()

Properties ​

address ​

address: string

Defined in: src/types/wallet-verification.types.ts:649

Wallet address being verified (must already exist on Coinbase).

Example ​

ts
`'0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B'`

customerEmail? ​

optional customerEmail?: string

Defined in: src/types/wallet-verification.types.ts:688

Optional end-user email. Forwarded to the API on create.

Example ​

ts
`'[email protected]'`

customerId ​

customerId: string

Defined in: src/types/wallet-verification.types.ts:663

Merchant identifier for the end user. Combined with address this is the reuse key - a verified pair returns status: 'verified' without opening Coinbase.

Example ​

ts
`'user-1234'`

mode? ​

optional mode?: CoinbaseVerificationMode

Defined in: src/types/wallet-verification.types.ts:669

'new-tab' (default) or 'redirect'. See CoinbaseVerificationMode.

Example ​

ts
`'new-tab'`

network ​

network: WalletVerificationNetwork

Defined in: src/types/wallet-verification.types.ts:655

Chain family of StartCoinbaseVerificationRequest.address.

Example ​

ts
`'evm'`

orderId? ​

optional orderId?: string

Defined in: src/types/wallet-verification.types.ts:682

Merchant order reference (metadata only).

Example ​

ts
`'order-9876'`

redirectUrl? ​

optional redirectUrl?: string

Defined in: src/types/wallet-verification.types.ts:676

Required for redirect. Optional for new-tab - omit to land on the Swapped “you can close this tab” page.

Example ​

ts
`'https://merchant.example.com/wallet-verified'`

webhookUrl? ​

optional webhookUrl?: string

Defined in: src/types/wallet-verification.types.ts:694

Optional override of the partner default webhook (server-to-server).

Example ​

ts
`'https://merchant.example.com/webhooks/wallet-verification'`