Getting started with Payway and Billecta

Target audience: Developers, Stakeholders

Introduction

To set up communication and start sales using Billecta in Payway there are a couple of steps you need to perform.

The setup consists of three larger steps

1. Setup and configure Billecta
2. Setup and configure Payway
3. Configure sales in payway

Getting started

Once the prerequisites above have been ticked off, you can get started with your implementation.

To place your first Billecta order with Payway, the following parameters are required:

Parameter	Description	Example value
account_id OR email	You can fetch the Account ID based on a customer's credentials by using our API here. You will find the customer's contact email in the PAP customer overview. If you wish to use our API, you can read more here.	adeprimo@servicedesk.com
product_code	The easiest way is to navigate to PAP -> Packages & Campaigns, and locate the product that you wish to sell. Once located, you will find the product code both in the table view as well as in the edit view. If you wish to use our API, you can read more here.	adeprimo_digital
period_id	You can find the associated period ids for a given product code using our API here.	5c6291d537c2ed78a11518b7
receipt_url	The receipt url that the customer should be redirected to upon purchase	https://adeprimo.se/receipt
billing_address	The billing address of the customer
first_name	The first name	Adeprimo
last_name	The last name	Servicedesk
street	The street address	Street 123
zip_code	The zip code	00100
country_code	The country code	FI

While more parameters can be defined, this is all you need for now.

After having defined these parameters, you will want to perform the following HTTP request, including the payload above:

curl --request POST \
  --url https://payway-api.stage.adeprimo.se/external/api/v2/accounts/create_order \
  --header 'accept: application/json' \
  --header 'authorization: Bearer token' \
  --header 'content-type: application/json' \
  --data '{
            "account_id": "",
            "product_code": "",
            "period_id": "",
            "receipt_url": "",
            "billing_address": {
              "first_name": "",
              "last_name": "",
              "street": "",
              "zip_code": "",
              "country_code": ""
            }
          }'

And that's it! Granted you got a 200 OK response, you have now successfully placed your first Adyen order with Payway, using account payment profiles!