SCI - Receive payments worldwide
Generate Payment Form/URL
Generate typical HTML snippets or URL to accept payments into your UnifiedPurse (Explanations of fields are at the bottom of the page)
The following parameters can be sent, through HTTP GET or POST request to the URL:
|Input Field Name||Description||Example Value|
|receiver||Receiver's UnifiedPurse username or firstname.lastname@example.org|
|amount||Total amount to be received||1000|
|currency||Currency can be any of BTC, LTC, ETH or any other currency that you have added for SCI by indicating the conversion rate here.||BTC|
|memo||Typically the payment description (maximum of 225 characters)||Purchase of XYZ products|
Unique transaction reference (maximum of 84 characters)
If not supplied, UnifiedPurse will automatically generate a unique reference.
But you supply a reference that you have already used for another transaction, an error will occur.
|notification_url||When a transaction has been completed, the transaction reference (under an HTTP POST key 'ref') will be posted to this url (even before the payer gets redirected to the success_url or cancel_url).
It is then advisable to rather perform all the needed confirmation check & updates on this url
|success_url||After successfully making the payment, the payer will be redirected back to this url, with the payment data also forwarded in an HTTP POST request||http://example.com/payment/success|
|cancel_url||If the transaction failed to complete, the payer will be redirected back to this url, with the payment data also forwarded in an HTTP POST request||http://example.com/payment/cancel|
Split Payment Support
NB: all notifications and actions will only be applicable to the primary(first) reciever. Others can only see the effect on their balances and transaction history.
|receiver2||Second receiver's UnifiedPurse username or email@example.com|
|receiver3||Third receiver's UnifiedPurse username or firstname.lastname@example.org|
|sf||The sharing formula, indicating what percentage of the total amount received will be remitted to receiver,receiver2 and receiver3. This must sum-up to 100||50-30-20|
Trusted Payer Priviledge (for 3-way payment support)
If you supply trust-token, all the following parameters becomes compulsory
Normally, if a payer that doesn't have account with unifiedpurse wants to buy crypto-currency from a exchanger on unifiedpurse in order to pay you, they will be required to register and perform KYC first;
However, if you vouch for them throug this trust_token (that you've already done KYC with them), then they will be be allowed to buy from exchanger to pay you as a single 3-way transaction without KYC
trust_token is generated by the following computation (you can implement the equivalent in any language)
Preliminary Response Object Properties
Properties of the
|ref||The custom transaction
|status||Current transaction status. For security, please validate this status from UnifiedPurse server.||1|
|payment_method||Can be any of bitcoin, litecoin, ethereum, paypal, payza, perfectmoney, paystack, rave, quickteller, interswitch_webpay, interswitch_paydirect, gtpay, ucollect, firstpay, zenith_globalpay, stanbic_bluepay, accesspay, remita, stripe, 2checkout, alipay, voguepay, national_bank_transfer, international_wire_swift, western_union, third_party_remittance, external_bitcoin, external_litecoin, external_ethereum||bitcoin|
|payment_method_label||E.g The Bitcoin Address, or Perfectmoney account to which the payment was received (where applicable)||176Kaox1dFYXskSrskyThmvtAnjxzr9Dfb|
More Fun-facts About
(Where dd-mm-yyyy represents the day,month and year). Examples: Product003-Customer-71-DLD-31-01-2020, or even with Time (in 24 hours format), Example: Product003-Customer-71-DLD-31-01-2020T16:30. The second exaple means that anyone will not be able to make payment with Product003-Customer-71-DLD-31-01-2020T16:30 as reference, after 4:30pm, of 31st January, 2020.
ref, that word with be automatically replaced by a random numerical value here
This may be useful when you want to indicate reference code in the transaction, without having to be generating the required unique value from your sever. Example: when your ref is Prod-xyz-URANDOM it will be changed to something like Prod-xyz-9876543212 here before the payment being made.
Payment Verification - Instant Payment Notification (IPN)
After receiving payments via this shopping-cart interface (SCI), it is important to verify that the payment was actually made by performing the payment confirmation step. Click here to see how to verify payments
Import manage and track your transaction history from you own webpage or admin portal, by pasting a snippet.