/payout_wallet
Generated from openapi.yaml. 4 operations.Download the specification.
POST/v1/payout_wallet
Set the payout wallet by signature
Proves control of the address off-chain and without gas: the wallet signs the challenge message, and the ed25519 signature is verified against the address. Get the message from /v1/payout_wallet/challenge first.
Requires your secret key as a bearer token.
Body
| Field | Type | Required | Description |
|---|---|---|---|
address | string | yes | Solana address to receive settlement |
message | string | yes | The challenge exactly as issued |
signature | string | yes | Base64 of the 64-byte ed25519 signature |
Responses
| Status | Description |
|---|---|
200 | The updated merchant |
400 | The signature does not verify against the address |
GET/v1/payout_wallet/challenge
Get a message for the wallet to sign
Requires your secret key as a bearer token.
Path and query parameters
| Name | In | Required | Description |
|---|---|---|---|
address | query | yes |
Responses
| Status | Description |
|---|---|
200 | payout_wallet_challenge with the address and the message to sign |
GET/v1/payout_wallet/link_tx
Build an unsigned transaction proving wallet control
The on-chain alternative to signing a message. Returns a transaction for the wallet to sign; submitting it is what proves control. Available only where the on-chain prover is configured.
Requires your secret key as a bearer token.
Path and query parameters
| Name | In | Required | Description |
|---|---|---|---|
address | query | yes |
Responses
| Status | Description |
|---|---|
200 | payout_wallet_link_tx with the address |
400 | On-chain wallet proof is not available in this deployment |
POST/v1/payout_wallet/link
Set the payout wallet by signed transaction
Requires your secret key as a bearer token.
Body
| Field | Type | Required | Description |
|---|---|---|---|
address | string | yes | |
memo | string | yes | The memo exactly as issued by link_tx |
signedTransaction | string | yes | Base64 of the wallet-signed transaction |
Responses
| Status | Description |
|---|---|
200 | The updated merchant |
400 | The proof does not verify |