Connect SDK

Appearance

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

Type Alias: CreateWalletVerificationRequest ​

CreateWalletVerificationRequest = object

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

Body for POST /api/wallet-verifications. Signature create usually runs inside the gateway iframe via VerifyWalletSignatureRequest; Coinbase create runs on the merchant page via StartCoinbaseVerificationRequest.

Properties ​

address ​

address: string

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

Wallet address being verified.

Example ​

ts
`'0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B'`

chainId? ​

optional chainId?: number

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

Satoshi method only - ignore for signature / OAuth.

Example ​

ts
`1`

customerEmail? ​

optional customerEmail?: string

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

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:274

Merchant identifier for the end user. Combined with address this is the reuse key - a verified pair short-circuits create.

Example ​

ts
`'user-1234'`

method? ​

optional method?: WalletVerificationMethod

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

Defaults to signature.

Example ​

ts
`'signature'`

network ​

network: WalletVerificationNetwork

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

Chain family of CreateWalletVerificationRequest.address. Signature today: evm and solana.

Example ​

ts
`'evm'`

orderId? ​

optional orderId?: string

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

Merchant order reference (metadata only).

Example ​

ts
`'order-9876'`

provider? ​

optional provider?: IntegrationProvider

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

Integration provider from GET /wallet-verifications/integrations (signature wallet id, or Coinbase).

Example ​

ts
`IntegrationProvider.MetaMask`

redirectUrl? ​

optional redirectUrl?: string

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

Required for exchange_oauth. Page you host; we send the browser back here with ?verificationId= and a hint ?status=.

Example ​

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

webhookUrl? ​

optional webhookUrl?: string

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

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

Example ​

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