Schemas

note

PayString was previously known as PayID.

See also: PayString API Reference.

The PayString protocol includes the following schema definitions.

These schemas are used for request or response payloads for various requests.

Example single user schema#

A single user can have multiple destinations, because the same user can have addresses on different networks for different currencies. This schema is used as a payload with a request to create a user, or as a response to a request to get information about a user.

{
"payId": "johndoe$xpring.money",
"addresses": [
{
"paymentNetwork": "XRPL",
"environment": "TESTNET",
"details": {
"address": "TVQWr6BhgBLW2jbFyqqufgq8T9eN7KresB684ZSHKQ3oDth"
}
},
{
"paymentNetwork": "XRPL",
"environment": "MAINNET",
"details": {
"address": "X7zmKiqEhMznSXgj9cirEnD5sWo3iZSbeFRexSFN1xZ8Ktn"
}
}
]
}
FieldDescription
payIdPayString user address
addressesObject that includes payment address information for one or more payment networks.
addresses.paymentNetworkA payment network, like the bitcoin network, the XRPL, or ACH.
addresses.environment"Environment" of the payment network for this payment address. For example, the XPR Ledger has MAINNET, TESTNET, and DEVNET.
address.detailsActual payment information for this address. Must be in the form CryptoAddressDetails or FiatAddressDetails. See Interfaces.