SCI - Receive payments worldwide
Getting paid is easy - generate payment Links, Buttons or QRCode
Button/URL redirection method (see sample)
<a href="https://unifiedpurse.com/sci?currency=USD&amount=1.5&receiver=YOUR_USERNAME&memo=Payment+for+shoes">Pay Via UnifiedPurse<a>
OR, Using Inline/Iframe method ()
<script src='https://unifiedpurse.com/assets/js/payment.js'></script> <button class='pay-with-unifiedpurse' data-receiver='YOUR_USERNAME' data-currency='USD' data-amount='1.5' data-memo='Payment for shoes' >Pay Via UnifiedPurse</button>
Generate buttons, URL or HTML snippets to share/integrate on you web/mobile apps for accepting universal payments, worldwide.
Generated Payment Snippets
SCI Parameters & Explanations
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 email@example.com|
|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 firstname.lastname@example.org|
|receiver3||Third receiver's UnifiedPurse username or email@example.com|
|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.