Conceal Wiki

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
conceal-pay [2019/09/01 03:58] – [Advanced payment with Instant Payment Notification] taegusconceal-pay [2020/02/24 19:53] (current) – boot2thrill
Line 1: Line 1:
-Conceal Pay is a product of **Conceal.cloud** and offers two extra ways of receiving payments in CCX+Conceal.Pay makes it simple for businesses and people to receive payments on the Conceal.Network. Conceal.Pay is seamlessly integrated with the Conceal.Cloud for absolute ease of use. You can easily create URLs with a simple web page where customers and friends can send you payments. Conceal.Pay makes it trivial for you or your business to receive payments online, fast.  
 + 
 +Conceal Pay is a product of [[https://conceal.cloud/login|Conceal.cloud]] and offers two extra ways of receiving payments in CCX.
  
 ====Simple payment request / donation ==== ====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 [[https://conceal.cloud/login|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.+The first method 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 of CCX can be predefined as well as a description of the payment/donation. To achieve, just go to [[https://conceal.cloud/login|Conceal.cloud]], create a wallet, click on the top menu for “**Conceal Pay**” and in the upper section of the page set the receiving address as well as your name. The predefined amount and message are optional. Once this is done you will get both URL and an HTML widget.
  
-Note that for this to work, both parties need to own a conceal clould account.+Note that for this to work, both parties need to own a [[https://conceal.cloud/login|Conceal.cloud]] account.
  
-**Step by step guide**+**__Step by step guide__**
  
 First click on Conceal Pay link in conceal.cloud, in the top block fill the address where the funds will arrive, then fill the name you would like for people to see. Amount can be predefined as well as the message that will appear inside the transaction metadata. First click on Conceal Pay link in conceal.cloud, in the top block fill the address where the funds will arrive, then fill the name you would like for people to see. Amount can be predefined as well as the message that will appear inside the transaction metadata.
Line 53: Line 55:
 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. 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.
  
-**Step by step guide**+**__Step by step guide__**
  
 For people wanting to integrate payments with conceal.pay system into their e-commerce or service’s website, we have a very functional feature to offer. This requires some technical knowledge, ideally made by the person who is a web developer. For people wanting to integrate payments with conceal.pay system into their e-commerce or service’s website, we have a very functional feature to offer. This requires some technical knowledge, ideally made by the person who is a web developer.
Line 67: Line 69:
 {{ :pay_ipn_01.png?direct&600 |}} {{ :pay_ipn_01.png?direct&600 |}}
  
-Name of the business is what will show up on the title (similar to how paypal works)+**Name of the business** is what will show up on the title (similar to how paypal works)
  
-Callback URL is what was described above, as well as success/failure URLs.+**Callback URL** is what was described above, as well as success/failure URLs.
  
-Nr. of retries is the amount of times our system will try to reach your callback URL in case of system errors until giving up.+**Nr. of retries** is the amount of times our system will try to reach your callback URL in case of system errors until giving up.
  
-Nr. of confirmations is the amount of confirmations that transaction needs to have before we trigger a call to your callback endpoint.+**Nr. of confirmations** is the amount of confirmations that transaction needs to have before we trigger a call to your callback endpoint.
  
 Once you click update, you will get a unique URL in the bottom that you need to integrate into your website. This is the url that you will redirect your user to after he selects CCX as a payment method. Once he has paid or cancelled, we redirect back respectively to your success or failure urls. Once you click update, you will get a unique URL in the bottom that you need to integrate into your website. This is the url that you will redirect your user to after he selects CCX as a payment method. Once he has paid or cancelled, we redirect back respectively to your success or failure urls.
  
-For example:+**For example:**
  
 https://conceal.cloud/pay/?client=d52a525899638058d36eeb83f5061ec6&amount=AMOUNT&ref=REF https://conceal.cloud/pay/?client=d52a525899638058d36eeb83f5061ec6&amount=AMOUNT&ref=REF
Line 91: Line 93:
 {{ :pay_ipn_02.png?direct&600 |}} {{ :pay_ipn_02.png?direct&600 |}}
  
 +That's it. Once the payment is done, user is redirected to a success URL you provided. After N amount of confirmations, we will make a call to your callback URL with the following data
 +
 +<code javascript>
 +[
 +    'amount' => 100,
 +    'fee' => 0.0001,
 +    'ref' => 'order-12345',
 +    'tx' => '36799a622bef667355b252fcc12e74667faee74e4259d3f19ea48f685a0fae66'
 +]
 +</code>
  
 +This will be a POST method call with JSON body as data. Your e-commerce platform will have to know how to handle this.