Skip to main content

Quickstart

Use this path when you want to get a switching integration working quickly in staging.

1. Register your application

Save these values immediately from the response:
  • clientId
  • clientSecret
  • webhookSecret
  • appPrivateKeyWrapped if you plan to use JWE

2. Exchange credentials for a token

Store the token value and send it as:

3. Create a subject

4. Create a paytag

The globally unique paytag becomes alice@walletapp.

5. Route a transaction

6. Handle the receiver webhook

The switch sends a TRANSACTION_INITIATED webhook to the receiving application. The receiver must:
  1. Verify X-Switch-Signature
  2. Optionally decrypt the payload if encryption is enabled
  3. Accept or reject the transaction through the API
Continue with Webhooks and Payments for the full flow.