Skip to main content

Releasing to Production

Getting Partner Account Set Up​

To go to production with HAPI Elements, you will need partnerId and partnerToken for production. To obtain these, contact your Partner Account Manager from VONQ. Partner Account Manager will ask you a couple of questions to correctly set up your account:

When your users will use wallet or purchase order or direct charge​

Partner Account Manager will be asking you a couple of more questions:

  • What currencies do you want your users to be able to pay with? Currently supported currencies are listed in ProductPriceCurrency enum
    • If you want USD:
      • Do you want US Bank Account enabled for users from US with wallet enabled?
    • For all currencies, including USD:
      • Do you want a minimum wallet top-up amount enforced to your users?
      • What minimum top-up amount do you want us to set for this currency?
      • Do you want a maximum outstanding balance (negative balance user will pay later) for purchase order?
      • What maximum outstanding balance amount do you want us to set for this currency? (minimum 0, maximum 99,999,999.00)
      • Do you want a maximum purchase order amount set per campaign order?
      • What maximum amount do you want us to set per campaign order when purchase order is selected? (minimum 0, maximum 99,999,999.00)

After your partner account has been set up, you will first be given credentials for Production environment and VONQ will work with the partner and conduct a series of end-to-end tests, before the partner can move to production and offer this feature to its customers.


Testing & Validation is performed within VONQ by the Partnerships Team, Product & Engineering and Operations.


Partners are not allowed to go live before all teams within VONQ give official approval.

Order testing on Job Marketing & Job Posting Sandbox Testing​

  1. Partner setups Sandbox environment. Refer to Sandbox Environment Setup.
  2. Partners send 2 test orders on production using Wallet method unless Partner asked to test other payment methods. Please add the following channels to the basket:
    1. Test order 1
      1. Werk.nl
      2. Diversity Outreach Network
      3. Organic Posting Network - Job Post
      4. My contract (Job posting, please ensure the credentials are correct)
      5. Ensure the working address has real address
    2. Test order 2
      1. LinkedIn - Job Posting - Light
      2. Ensure the working address has real address
  3. Partner sends Campaign ID(s)
  4. VONQ checks and updates the campaign status and informs the partner
  5. Partner confirms status has been updated
  6. Partner is ready to switch to the production environment

Job Marketing Production Testing Steps​

  1. Partner setups Production environment. Refer to Production Environment Setup.
  2. Partner to Top up Wallet or using other payment method
  3. Partner sends 1 order on production using Wallet method unless Partner asked to test other payment methods. Please add the following channels to the basket:
    1. Werk.nl
    2. Diversity Outreach Network
    3. Organic Posting Network - Job Post
    4. My contract (Job posting, please ensure the credentials are correct)
    5. Ensure the working address has real address
  4. Send campaign ID to VONQ
  5. VONQ will review and reject and refund the order. It can take up to 5 working days for the funds to be back on the account.
  6. Partner sends another order on production for end-to-end testing. The order contains only one product, which is:
    1. LinkedIn - Job Posting - Light
    2. Ensure the working address has real address
  7. Partner sends Campaign ID
  8. VONQ reviews the order and publishes it online. VONQ will refund the order. It can take up to 5 working days for the funds to be back in the account.
  9. All tests are successful, and partners can "enable" it for their users

Job Post Production Testing Steps​

  1. Partner setups Production environment. Refer to Production Environment Setup.
  2. Go through the Features checklist for Job post
  3. Partners send test orders on production
    1. Ensure the actual/correct credentials are entered for the contract if end-to-testing is required
  4. Partner sends Campaign ID(s)
  5. VONQ reviews the order and publishes it online if credentials are valid. If invalid credentials are given. VONQ will only review the order
  6. All tests are successful and partner can "enable" it for their users

Features Checklists​

Job Marketing Features​

Job Marketing Required FeaturesJob Marketing Optional Features
Search and recommend productsSearch by product name
Show delivery time per channel (including time to process first posting)Filter by audience type, media type
Show crosspostingsRetrieve logos for all products
Show product prices in EUR and/or GBP and/or USD and/or AUDSort portfolio by recency, relevance, price
Add multiple products to campaignDisplay screen with latest channel additions (sort by recency)
Application, Job Page URL and UTM Codes are prefilled

Refer to Prefilling Required Campaign Information		Specify if vacancy allows remote work
Order a campaign
Retrieve campaigns per customer
Check campaign status
Show delivery time per campaign and per product
Retrieve channel status
Take campaign offline
Retrieve live job link
Show clicks per campaign and per product
Show delivered on and duration of campaign
AI Smartfill introduced in version 2.5

Job Post Features​

Job Post Required FeaturesJob Post Optional Features
All features of HAPI Job MarketingOrder campaign - mixed (HAPI Job Post and HAPI Job Marketing) or non-mixed
Editing Job / Ads on (SEEK, France Travail, Hotel Career, Bundes Agentur Fur Arbeit).
Search complete portfolio by support for my contracts
Connect channel to customer contract
List connected contracts per customer
Add multiple contracts per channel
Delete contracts
All job board authentication methods are supported (eg. oAuth, XML feed etc.)
Job board instructions / confirmation check box are shown at the top of the form
AI Smartfill introduced in version 2.5

Payments Features​

Payments Required FeaturesHAPI Payments Optional
Add and/or edit billing details
Create wallet (done automatically by Elements)ACH Direct Debit
Top-up wallet
Retrieve wallet balance (done automatically by Elements)
Purchase Order / Invoice

Post Live Campaign Feedback​

In the first 4 weeks VONQ will conduct additional manual checks on the order intake to make sure orders are correctly filled with the correct values and information.

  • Orders which don't fit the requirements will be rejected and the partner will be notified for either changes to the API or user training

  • Orders which are in line with the requirements will be automatically processed

After the go live phase VONQ expects all orders to be delivered in line with the requirements and will not conduct a manual check anymore.