Create Wallet
GET
https://api.shieldclimb.com/control/wallet.php
GET request. Your request must include two required parameters: the payout wallet address and your callback URL. When the request is valid, the API will respond with HTTP 200 OK and return both the encrypted temporary wallet address and your callback URL in JSON format.Request Parameters
address: Provide the USDC (Polygon) wallet address where payouts should be sent after the customer completes their transaction. This must be a valid Polygon USDC address.(Important: Only Polygon USDC addresses are supported.)
callback: Include a URL-encoded callback URL. The confirmation notice will be sent to this URL via a GET request once the payment is completed. To ensure a new temporary wallet is issued, the callback must contain at least one unique GET parameter each time. Using the exact same parameter value more than once will return the same temporary receiving address. Use your own callback URL in production—avoid testing domains such as yourwebsite.com.Response Explanation
address_in: An encrypted temporary wallet address. This value must be passed into the second step (Process Payment). Do not send the decrypted address to the next step.polygon_address_in: The decrypted temporary wallet address is provided to help you track incoming payments. This address is only for monitoring — it cannot be used in the second step.callback_url: Your original callback URL is returned in decoded form. When the customer finishes the payment, our bot will send a GET request to this exact URL, including all parameters you initially sent, plus an extra parameter value_coin, which represents the actual USDC amount delivered by the payment provider. This can be helpful if your system wants to validate the received amount.ipn_token: A unique tracking token. If you ever need support or need us to investigate a callback or payment status, sharing this token allows us to locate your transaction quickly.Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.shieldclimb.com/control/wallet.php?address=0x9eC55CCbDa93bCEe3936e5CaC76cA623f5BF6E9B&callback=https%3A%2F%2Fyourwebsite.com%2Forder-ipn%3Forder_id%3D123456'Response Response Example
{
"address_in": "NcLqIRBeKMlsekrlFq7nkZo51eisaUSF7oF3180oDzBPl5c6LLysu%2F8tfkvnndyRMJLzrUY8C4a2wCYJ1pNpMA%3D%3D",
"polygon_address_in": "0xED88D23E4c9372a4B25c941eBa0901ED513c9B58",
"callback_url": "https://yourwebsite.com/order-ipn?order_id=123456",
"ipn_token": "ZEE2cW8zb1N0N2p3Ykd5dDFSQTBVejhLMEExYmVvcDBVNlVBcEl6Q2RncmNCQUstaGJtdktPdHZtNl9LRTJGR3VR"
}Modified at 2025-12-14 08:46:15