Skip to main content
POST /accounts/virtual/payin/address creates a permanent pay-in wallet under the merchant’s virtual account. Deposits are swept to the parent account.

​
Request

Requires API key and request signature when signature verification is enforced.

​
Fields

The parent virtual account must exist, be enabled, and in Ready state. The chain must be enabled on the platform.

​
Response (shape)

Persist address and account_id next to your user record. Creating again for the same reference/chain returns the existing wallet when already provisioned (idempotent behaviour from the account store).

​
Request signing

Build X-API-Signature as described in Authentication: HMAC_SHA256(secret, METHOD + PATH + NONCE + QUERY + BODY).

​
Show address to users

Display the address only for the chosen chain. Educate users not to send assets from incompatible networks.

​
Credit your ledger

Watch for payment webhooks involving deposit payment methods / successful payments tied to that customer, and verify signatures. Prefer a conservative rule: credit only on successful, verified payment events that match your reference / customer mapping.

​
Next step

Cookbook: User Balance Deposits