Paymail

Customize your paymail domain.

Paymail is a alias protocol that let's users pick a easier identifiable address (such as [email protected]) and increases computational efficiency due with the peer-to-peer (P2P) approach.

P2P means that instead of the receiver needing to search the blockchain for a incoming transactions (potentially among billions), the receiver gets directly the transaction bundle which the receiver then submits to the miners and to instantly get a payment confirmation.

To add your own paymail domain to your dedicated server (with a serviceID), you need to append to the your-domain.com/.well-known/bsvalias path the following json file.

{"bsvalias":"1.0","capabilities":{"6745385c3fc0":false,"pki":"https://api.relysia.com/v1/bsvalias/id/{alias}@{domain.tld}","paymentDestination":"https://api.relysia.com/v1/bsvalias/address/{alias}@{domain.tld}","a9f510c16bde":"https://api.relysia.com/v1/bsvalias/verifypubkey/{alias}@{domain.tld}/{pubkey}","5f1323cddf31":"https://api.relysia.com/v1/bsvalias/receive-transaction/{alias}@{domain.tld}","2a40af698840":"https://api.relysia.com/v1/bsvalias/p2p-payment-destination/{alias}@{domain.tld}"}}

you find examples of the entry at all major wallets, including https://relysia.com/.well-known/bsvalias. Once you added the entry to your domain & set up the serviceId with given domain, your paymail will be active.

Get paymail Id details

GET https://api.relysia.com/v1/paymail/:paymailId

Get a paymail account details.

Path Parameters

Name	Type	Description
paymailId*	string

200: OK

{
  "statusCode": 200,
  "data": {
    "status": "success",
    "msg": "Operation successful",
    "paymailDetails": {
      "walletID": "ec4ae905-c5ef-41bd-adfb-4db361093245",
      "paymailId": "[email protected]"
    }
  }
}

you can change your paymail to any of your personalized choice, but each paymail should be unique so before setting your personalized paymail we will check if already not exists in our system.

Update paymail

PUT https://api.relysia.com/v1/paymail

Set a paymail to your personalized choice

Headers

Name	Type	Description
walletID	string

Request Body

Name	Type	Description
newPaymailId*	string

200: OK

{
  "statusCode": 200,
  "data": {
    "status": "success",
    "msg": "operation completed successfully !",
    "paymail": "[email protected]"
  }
}

Activate/Deactivate paymail

POST https://api.relysia.com/v1/paymail/activate

If you want to change your paymail status you can use this endpoint

Headers

Name	Type	Description
walletID	string

Request Body

Name	Type	Description
activate	boolean

200: OK Activate paymail

{
  "statusCode": 200,
  "data": {
    "status": "success",
    "msg": "paymail activated now"
  }
}

200: OK Deactivate paymail

{
  "statusCode": 200,
  "data": {
    "status": "success",
    "msg": "paymail deactivated now"
  }
}