Glossary

Glossary

Definition
Meaning
Midlayer
The Woosa server that sits between your shop and Adyen. You send your requests here.
Adyen
The payment processor that actually moves the money. You never call it directly.
PSP reference (pspReference)
The unique id Adyen gives a payment. Your handle for capturing, refunding, or cancelling it.
Store ID (store_id)
The id of a store you created. It goes in the URL of most payment calls.
Contractor
The legal entity (company or individual) that receives the money.
woosa_secret
The secret key Woosa gives your shop during registration. Used to sign every request.
Signature
A tamper-proof seal computed per request, proving it came from you and was not altered.
HMAC-SHA256
The standard one-way scrambling function used to build the signature.
Basic Auth
A simple API login where the caller sends a username and password. Woosa uses your key and secret this way when calling your shop back.
Authorise
Authorise the payment method (e.g. credit card) of the customer, but not yet charge the actual card.
Capture
Charge the payment method of the customer that was authorised.
Onboarding / KYC
The identity and compliance checks a merchant must pass before taking real payments.
Tokenise / stored payment method
Saving a shopper's card or method so they can pay again later with one click, or for subscriptions.
Minor units
The smallest unit of a currency. Cents for euros. 28.00 EUR is 2800.
Metadata
Free-form data (like your own order id) that you attach to a payment and Woosa gives back to you later, so you can match payments to orders.