RUC Transaction API

Start selling RUC inside your platform in weeks, not years

Bring official RUC purchasing into your product with a single integration. Customers stay inside your app or website. RUC on Rails handles the validation, NZTA request, event history, and settlement logic behind the scenes.

Everything you need to offer RUC

Add RUC with almost no engineering

Use your existing screens, flows, and payments. Add one API call and your platform can sell RUC.

Flexible pricing

RUC is passed through at the official NZTA rate. You decide how to price your service and keep the margin.

No ongoing overhead

There is nothing to run or maintain. If your customers don't buy RUC, you don't pay anything.

How it works

Customer enters vehicle plate

Your app calls Quote API

POST /v1/quotes

{ plate: "ABC123", distance_km: 1000 }

Price: $76.00 NZD

Customer confirms purchase

Your app calls Transaction API

POST /v1/transactions

{ vehicle_plate: "ABC123", ... }

RUC licence issued instantly

Licence #814313398

Customer receives receipt

Digital receipt with licence details sent via email

Make RUC part of your platform without adding complexity

Normally, supporting RUC requires handling validation rules, NZTA communication, licence states, event logs, audit data, and reconciliation.

The RUC Transaction API removes all of this. Your developers integrate a straightforward API. RUC on Rails handles the full workflow behind the request.

You stay focused on your product. We take care of the parts that need to be accurate every time.

Customer selects RUC

Your server calls our API

RUC on Rails processes the request

NZTA issues the licence

We store the full record

You show the confirmation

You receive one monthly invoice

Built for developers

The RUC Transaction API feels like any modern infrastructure API.

Clear, consistent endpoints

JSON requests and responses

Safe to retry

Dedicated sandbox

Optional webhooks

Comprehensive documentation

Get a price quote

const

quote = await fetch('https://api.ruconrails.co.nz/v1/quotes', {

method: 'POST',

headers: {

'X-API-Key': 'ruc_live_xxxxx'

body: JSON.stringify({

vehicle_plate: 'ABC123',

distance_km: 1000

})

});

Purchase RUC for a vehicle

const

response = await fetch('https://api.ruconrails.co.nz/v1/transactions', {

method: 'POST',

headers: {

'X-API-Key': 'ruc_live_xxxxx',

'Content-Type': 'application/json'

body: JSON.stringify({

vehicle_plate: 'ABC123',

distance_km: 1000,

odometer_start: 367431,

odometer_end: 368431

})

});

Why businesses use it

Fast to launch

Add RUC without building new systems, hiring specialists, or managing a certification process.

Designed to scale only when you do

There are no upfront commitments. If your customers do not buy RUC, there is nothing to pay or maintain on your side.

Revenue ready

You keep control of pricing. RUC becomes a practical way to bring customers back to your platform and create predictable revenue.

Less operational burden

You avoid maintaining audit logs, data consistency, and settlement workflows. Everything is handled inside RUC on Rails.

Make your platform the easiest place to buy RUC

With one integration, you offer customers a simple way to buy RUC inside the app or site they already use. You own the experience and the revenue. RUC on Rails handles the infrastructure and the regulated logic behind it.