[Optional] Create Wallet - Affiliate - ShieldClimb Developer API

This optional endpoint is designed for advanced white-label setups where you want full control over payout redistribution and commission handling. It works similarly to the standard affiliate endpoint, but introduces two additional parameters—sub_affiliate_fee and merchant_fee—which allow you to define how the final payout is split between the merchant and the affiliate.

When calling this endpoint, you are creating a temporary receiving wallet with custom payout logic baked in. The payout is instantly distributed according to the fee percentages you specify. The affiliate and merchant wallet addresses must be different, otherwise the request will be rejected.

To complete the configuration, you also need to pass the sub_affiliate parameter, which represents the affiliate wallet address that should receive the commission based on sub_affiliate_fee.

sub_affiliate_fee : Defines the percentage routed to the affiliate wallet. For example, a value of 0.01 means the affiliate receives 1% of the total payout.

merchant_fee : Defines the percentage sent to the main merchant wallet. For instance, if you set merchant_fee to 0.975, the merchant receives 97.5% of the final payout.

Both values must always add up to 0.985, as the remaining 1.5% is the fixed service fee.

If the combined total does not equal 0.985, the request will be rejected.

Request Parameters

address : Your merchant’s payout wallet address.

callback : URL-encoded callback URL that will receive the payment confirmation.

merchant_fee : Merchant’s percentage of the payout (e.g., 0.975).

sub_affiliate_fee : Affiliate’s percentage of the payout (e.g., 0.01).

sub_affiliate : The affiliate wallet address that should receive the commission.

curl --location --request GET 'https://api.shieldclimb.com/set-affiliate.php?address=0x9eC55CCbDa93bCEe3936e5CaC76cA623f5BF6E9B&callback=https%3A%2F%2Fyourwebsite.com%2Forder-ipn%3Forder_id%3D123456&merchant_fee=0.975&sub_affiliate_fee=0.01&sub_affiliate=0x6837D4577BFAdb8f0072aeB7Bc99B6DeA55Ba55A'

{ "address_in": "Mh%2F5EFIymeKvhEhWLwllv49Qp5qtx8jxUSJKnYxlnPL9NW3nkk5eMELrzOv13iasM%2BcxaxvFwGh655g%2FuQmzcQ%3D%3D", "polygon_address_in": "0xED88D23E4c9372a4B25c941eBa0901ED513c9B58", "callback_url": "https://yourwebsite.com/order-ipn?order_id=123456", "ipn_token": "ZEE2cW8zb1N0N2p3Ykd5dDFSQTBVejhLMEExYmVvcDBVNlVBcEl6Q2RncmNCQUstaGJtdktPdHZtNl9LRTJGR3VR" }

[Optional] Create Wallet - Affiliate

Request Parameters#

Request

Responses

Request Parameters