Invoices
Create a BitcoinSV or Token Invoice
When buying goods in supermarkets or online shops, customers are not asked to type in the exact amount to spend from their credit card, instead, they just get to see a fixed amount that they can decide to pay or not pay. We call systems that pre-determines an amount and requests payments "invoice systems"
The advantage of "invoice" based system is that there is no room for failure outside payment success or decline.
The structured process to create invoices is called BIP270 and is adopted by a variety of wallets such as SimplyCash, Centi or Handcash. A invoice created via the Relysia API can thus be understood by a variety of wallets and be universally used for BSV gateway systems.
DPP (Direct Payment Protocol) is an expanded version of the BIP270 process that allows payment invoices to include Stas tokens and additional data for the beneficiaries of the payment. The "modeId" value of "ef63d9775da5" is a standard identifier for DPP payments that is an accepted data format for the invoice. The "native" or "stas" objects can be used to specify the desired transaction type and amount. The "amount" value in the "native" object is used to specify an amount in BSV.
DPP
BIP270
{
"expirationTimeInMinuts": 0,
"memo": "string",
"paymentOptions": [
{
"transactions": [
{
"native": {
"amount": 0,
"to": "string"
},
"stas": {
"tokenAmount": 0,
"tokenRecipient": "string",
"tokenId": "string"
}
}
]
}
],
"modeId": "ef63d9775da5",
"beneficiary": {
"name": "string",
"email": "string",
"address": "string",
"paymentReference": "string"
}
}
{
"type": "string",
"amount": 0,
"address": "string",
"merchantData": "string",
"description": "string",
"expirationTimeInMinuts": 0,
"memo": "string"
}
post
https://api.relysia.com
/v1/invoice
Create an invoice.
Whenever selling a product for BSV or Stas token, the invoice system is the system of choice.
get
https://api.relysia.com
/v1/payment-request/:invoiceId
Get an Invoice details
post
https://api.relysia.com
/v1/payment-request/pay/:invoiceId
Settle an invoice request.
Last modified 2mo ago