Class Track1.Builder

java.lang.Object
org.jpos.core.Track1.Builder
Enclosing class:
Track1
public static class Track1.Builder extends Object
Fluent builder that parses a raw track1 string or assembles a Track1 from individual fields and validates the result against a configurable pattern.
Since:
jPOS 2.0.5

  • Method Details

    • pan

      public Track1.Builder pan(String pan)
      Sets the primary account number.
      Parameters:
      pan - primary account number
      Returns:
      this builder

    • nameOnCard

      public Track1.Builder nameOnCard(String nameOnCard)
      Sets the cardholder name.
      Parameters:
      nameOnCard - cardholder name as encoded on the track
      Returns:
      this builder

    • exp

      public Track1.Builder exp(String exp)
      Sets the expiration date.
      Parameters:
      exp - expiration date in YYMM form
      Returns:
      this builder

    • cvv

      public Track1.Builder cvv(String cvv)
      Sets the CVV/CVC value.
      Parameters:
      cvv - CVV/CVC value
      Returns:
      this builder

    • serviceCode

      public Track1.Builder serviceCode(String serviceCode)
      Sets the service code.
      Parameters:
      serviceCode - three-digit service code
      Returns:
      this builder

    • discretionaryData

      public Track1.Builder discretionaryData(String discretionaryData)
      Sets the discretionary data trailing the service code.
      Parameters:
      discretionaryData - discretionary data trailing the service code
      Returns:
      this builder

    • pattern

      public Track1.Builder pattern(Pattern pattern)
      Optional method, can be used to override default pattern
      Parameters:
      pattern - overrides default pattern
      Returns:
      this builder

    • track

      public Track1.Builder track(String s) throws InvalidCardException
      Parses a raw track1 string and populates the builder fields.
      Parameters:
      s - raw track1 data
      Returns:
      this builder
      Throws:
      InvalidCardException - if s is null or does not match the configured pattern

    • buildTrackData

      public Track1.Builder buildTrackData()
      Constructs the Track1 data based on the card data provided. The generated Track1 data is validated using the pattern. If the Track1 data doesn't match the pattern, the track attribute keeps the original value.
      Returns:
      this builder.

    • build

      public Track1 build()
      Builds the immutable Track1. If no raw track string was set, one is assembled from the individual fields via buildTrackData().
      Returns:
      the built Track1