Skip to main content
Address verification is in Developer Preview. Endpoints and schemas are subject to change. To participate, contact Paxos Support.

​
Which verification method should I use?

Start with SIGNATURE if the address holder can sign a message directly or through a wallet integration. It resolves immediately and has no on-chain cost. Use SMALL_DEPOSIT if the address holder cannot sign, for example if the address is held by a custodian, a hardware wallet with restricted signing, or a smart contract. Sending the transaction will incur a small gas cost. If neither works, contact Paxos Support to initiate a MANUAL review for additional verification requirements that have not yet been automated. Manual review is handled off-platform and is not created through the public API.

​
Can a wallet collect signatures on behalf of users?

Yes. Your backend creates the verification record and sends the wallet only the details needed for signing: verification id, network, address, signature_verification.message, and expires_at. The wallet prompts the user to sign the exact message, then returns the signature to your backend. Your backend submits the signature to Paxos. Do not expose Paxos client credentials, client secrets, or OAuth tokens to wallet frontends or third-party collectors. No. Address verification confirms control of the address for the requested Paxos use case, such as establishing reward claim eligibility. It does not determine custody, title, or legal rights over the address, wallet account, or funds.

​
My signature was submitted but the verification is still PENDING. Why?

An invalid signature leaves the verification in PENDING. Common causes:
  • Wrong signing standard. EVM networks use EIP-191 personal_sign. Solana uses ed25519.
  • Message modified before signing. Sign signature_verification.message exactly as returned. Do not trim whitespace, change the nonce, or re-encode the string.
  • Wrong key. Make sure you are signing with the private key that controls the address in address.
Call Submit Signature again with a corrected signature. The verification stays open until it approves or expires.

​
My small deposit was sent but the verification hasn’t approved. What should I do?

Paxos detects deposits after on-chain confirmation, which can take a few minutes. If the verification is still PENDING after 10-15 minutes:
  • Confirm the transaction was sent from the address under verification for the exact amount shown in small_deposit_verification.amount. Paxos checks both.
  • Check small_deposit_verification.deposit_address in the verification response and confirm the transaction went to that address.
  • You can send again from the same address if needed.
If the verification still has not resolved, contact Paxos Support with the verification id and the on-chain transaction hash.

​
My verification expired. What do I do?

Create a new verification via Create Address Verification. Expired verification IDs cannot be reused or extended. For SIGNATURE verifications, sign the new message and nonce returned in the new verification. The previous nonce is no longer valid. For SMALL_DEPOSIT verifications, send a deposit to the new deposit_address in the new verification response.

​
I sent the wrong amount for a small deposit. What happens to the funds?

Any amount sent to the deposit address is credited to your default Paxos profile. Send the exact amount shown in small_deposit_verification.amount from the address under verification within the 48-hour window. The verification stays PENDING until the correct amount from the correct address is detected.

​
I created a verification for the wrong address. What do I do?

Let the verification expire, then create a new verification for the correct address. You cannot modify the address on an existing verification.

​
I created a small deposit verification but want to use signature instead. Can I switch?

You cannot change the method on an existing verification. Wait for the current verification to expire (up to 48 hours from creation), then create a new verification with "verification_method": "SIGNATURE".
Questions? Contact Support.