Skip to main content

Get Started as a Software Platform Partner

H
Written by Hayko

Get Started as a Software Platform Partner

This guide is for companies that build software used by many merchants, such as a WMS, a shop platform, an order management system or shipping software, and want to offer QrX Payment on Delivery inside their product. You integrate once. Each merchant then connects their own QrX account to your software with a few clicks through QrX Connect, without copying API keys.

In PortalX this is the setup path I build software and want to connect my merchants in the Get Started guide (Settings > Business > Get started).

How It Works

  • Each merchant keeps their own QrX account, payment provider and carrier setup.

  • The merchant clicks "Connect QrX" in your software, signs in on QrX, picks a sales channel and clicks Allow.

  • Your server receives the API key for that one channel and calls the QrX Public API on the merchant's behalf.

  • The consumer door payment always stays on go.qr-x.app. Your software never touches the payment itself.

1. Set Up Your Own Account

  1. Complete your company details. QrX keeps the company name, address and VAT or Chamber of Commerce number from your signup. If something is missing or changed, click Ask QrX in the step and QrX completes it for you. The step ticks when all details are known.

  2. Invite your developers in Settings > Team & Access > Users.

2. Request Your QrX Connect Client Id

Click Ask QrX in the step (it opens the chat), or use qrx.eu/api. Give QrX your product name and your HTTPS callback URL. Each integration gets its own client id.

3. Build the Connection

  1. Send the merchant to https://portal.qr-x.app/oauth/authorize with your client id, callback URL, a random state and a PKCE challenge (S256).

  2. On your callback, check the state and exchange the code: POST https://api.qr-x.net/api/v1/oauth/token (authorization_code with code_verifier). The code works once.

  3. Store the returned channel API key encrypted on your server.

  4. Exchange it for an access token with POST /api/v1/auth/token and call the API like any merchant integration.

Details: "QrX Connect: Connecting Your Platform With OAuth" and the reference at qrx.eu/api.

4. Create a Test Transaction for Your First Merchant

  1. Connect a test merchant (your own QrX account works) with QrX Connect.

  2. Create a transaction in test mode with a label: POST /api/v1/transactions.

  3. Subscribe to webhooks for that channel and verify the X-QrX-Signature header.

  4. Scan the QR code on the test label and complete a test payment at the door.

5. Certify With QrX

Before merchants use your integration live, QrX checks the complete flow with you: label output on the printers your merchants use (PDF or ZPL, UPS Standard or Extended label), retries that never create a second label, webhook handling, and cancellation. Book this through Ask QrX in the step.

Partnership

QrX offers partner fees for eligible activity. Terms are agreed per partnership; see "Partners and How to Partner With QrX".

When to Contact Our Support Team

Contact QrX to request or change a client id or callback URL, when the token exchange keeps failing with a valid code, or to plan certification.

Related Articles
Did this answer your question?