Flattened Dot Notation Parameters

payment.amount=10.00&currency=USD
https://api.paystand.co/v3/plugins/paystand/checkout?k=0yqowfwfxb2vpnuv9ovpqvgt&t=classic&l=desktop&p.a=10.24&c=USD&b.s=41 Grandview St&b.c=Santa Cruz&b.p=95060&b.d=CA&b.u=USA&y.n=Christina Chan&y.e=demo%[email protected]&z.foo.bar=quux&z.foo.baz=norf&m.0=echeck&m.1=card
https://api.paystand.co/v3/plugins/paystand/checkout?k=5xscm967dw77l5yhl641eqp9&c=USD&m.0=echeck&m.1=card&b.s=100 Bay St&b.c=Santa Cruz&b.p=95060&b.d=CA&b.u=USA&y.n=Christina Chan&y.e=demo%[email protected]&z.foo.bar=quux&z.foo.baz=norf&r.n=One year lease&r.d=120 Swift St. 12 Month Lease&r.i.0.n=Monthly Rent&r.i.0.d=Rent of $1200 is due on the first of every month&r.i.0.s.n=Rent&r.i.0.s.d=Pay rent on the 1st of the month&r.i.0.s.i=month&r.i.0.s.c=1&r.i.0.s.a=start&r.i.0.s.s=2016-04-01T00:00&r.i.0.s.t=12&r.i.0.a=1200.00&r.i.1.n=Application Fee&r.i.1.d=One time application fee of $150.00&r.i.1.s.n=Application Fee&r.i.1.s.d=Pay a one time non-refundable application fee&r.i.1.a=150.00&r.i.2.n=Security Deposit&r.i.2.d=$2000 Refundable security deposit that can be used to cover damages&r.i.2.s.n=Deposit&r.i.2.s.d=Security deposit or the home&r.i.2.s.s=2016-04-01T00:00&r.i.2.a=2000.00

For use cases where the URL encoded, JSON formatted init parameter does not work well, the Billing Portal can alternatively be initialized by adding parameters to the URL. For each value in the init object that needs to be set, a URL parameter is added and named using the flattened dot-notation format.

The Flattened Dot Notation Parameters is a concatenation of all the names for each level of the hierarchical object structure separated by a dot starting with the root all the way down to the targeted property.

For example, the payment amount of $100 can be specified by adding ?payment.amount=100&currency=USD to the base url.

When the init object includes an array, such as the array of scheduled items for a scheduled payment, each item in the array should be specified separately using the numerical index. For example, r.i.0.n=Item One Name&r.i.0.d=Item One Description&r.i.1.n=Item Two Name&r.i.1.d=Item Two Description.

📘

Shorthand using abbrevations

Both Billing Portal initialization methods support the same parameter name abbreviations as checkout. This is especially important given that the total URL length is limited to 4 Kbyte and can get quickly inflated when metadata or a complex scheduled payment is added.