Conceal Wiki

Trace: conceal-pay

Conceal-pay

Conceal Pay is a product of Conceal.cloud and offers two extra ways of receiving payments in CCX

Simple payment request / donation

First one is a simple HTML widget that allows users to place a button on their website or just share a link and get paid. The amount can be predefined as well as a description of the payment/donation. To achieve this just go to Conceal.cloud, create a wallet, click on the top menu on “Conceal Pay” and in the upper section of the page set the receiving address as well as your name. Predefined amount and message are optional. Once this is done you will get both URL and an HTML widget.

Advanced payment with Instant Payment Notification

Second method is more advanced and can be integrated into more complex websites. The principle of functioning is similar to PayPal’s API with IPN. To achieve this just go to Conceal.cloud, create a wallet, click on the top menu on “Conceal Pay” and in the lower section of the page find the wallet that you want to use to receive payments and fill the necessary fields.

Name of the business: The name of your website or online service

Callback URL: This is your internal website’s URL that will receive the confirmation from our side once the payment goes through to your wallet. This endpoint will be called by our system by a [POST] method with the following raw json data

{ 
   "amount":1,
   "fee":0.0001,
   "ref":"yourInternalPaymentReferenceGoesHere",
   "tx":"transactionHasGoesHere"
}

URL to redirect on successful payment: This is the URL of your service to which conceal.cloud will redirect the user after successful payment.

URL to redirect on failed payment: This is the URL of your service to which conceal.cloud will redirect the user after failed payment.

Number of retries to call callback URL (max. 10 times): Amount of times conceal.cloud will try to reach your service to give a successful callback in case of an initial failure (networking, system down, etc.)

Number of confirmations before calling callback URL: Threshold of confirmations for the transaction before informing your service that the payment is successful.

Once all the fields are set, you will receive the URL that you need to use in your website/service to redirect in case your user wants to pay with CCX. This URL needs to be updated with the amount and your internal payment reference for later matching from our side in case of success.