Skip to main content

What is AutoRenew and how does it work?

AutoRenew is a parameter in /card-management/v1/ordercard
It controls whether the system automatically creates a replacement card when the current card approaches its expiry date.

It can be setup during card order /card-management/v1/ordercard, and/or controlled during card life time using /card-management/v1/autorenew

Allowed values

Value Meaning Behaviour
1 As per card type setting (Default)
  • Behavior depends on the card type configuration in backend.
  • Some card types renew automatically; others don’t.
2 Auto‑renew enabled
  • A renewal card is automatically produced shortly before expiry.
  • The renewal card keeps the same PAN + PIN, but has a new expiry date.
  • The system sends this replacement card automatically, without manual ordering.
3 Auto‑renew disabled
  • The card expires normally.
  • No renewal card is produced.
  • A new card will exist only if the customer orders one.

Why AutoRenew may not fit all customer workflows

Some customers use their own internal card‑management or fleet‑management systems.
In such setups:

1) Renewal cards may appear without being registered internally

If cards are renewed automatically, the customer’s system may not know that a new card exists. It is important to implement additional logic for auto-renewed cards. 

2) Manual ordering + automatic renewal can overlap

If the customer orders a new card based on their own rules, and AutoRenew also creates one, the customer may receive two different cards for the same user.

3) Card lifecycle may not stay aligned across systems

The customer may treat the old card as expired and deactivate it internally, while a renewed version is already active.

4) Internal processes may rely on explicit orders

Some customers choose to track every plastic card individually.
For them, renewal only works smoothly when they control when each new card is created. 

About us

The Shell Developer Portal supports partners in onboarding to Shell APIs and turning ideas into production-ready solutions.

 

Shell logo

Contact

Login to your account

Ask AI Assistant about Shell APIs and API Products