Gift Card
gift card 'gift card' cards support enrolling prepaid cards also known as gift certificate, gift voucher or gift token links urls to get balance and transactions history in real time is provided in the partners portal if a partner needs to integrate communication between samsung wallet server and the partner’s server to support the feature, the partner has to set the links in partners portal wallet card type wallet card type wallet card subtype giftcard others others wallet card data fields attributes type value description attributes {fields} title string 32 required main title e g , samsung gift card eventid string 36 optional if full cancelation of the event occurs, find and process all gift cards with this id orderid string 36 optional a unique identifier for an order subtitle1 string 32 optional the auxiliary field which displays supporting information logoimage string 256 optional logo image url to be displayed in the card item the file size should not exceed 256 kb logoimage darkurl string 256 optional logo image url in dark mode the file size should not exceed 256 kb logoimage lighturl string 256 optional logo image url in light mode the file size should not exceed 256 kb providernamestring 32 required gift card provider name user string 64 optional name of person who holds the gift card preventcaptureyn string 1 optional flag whether this wallet card view prevents screen capture either 'y' or 'n', the default value is 'n' startdate long 13 optional start date display start date epoch timestamp in milliseconds enddate long 13 optional end date display end date epoch timestamp in milliseconds locations string 1024 optional list of locations where the gift card can be used * see location format noticedesc string 5000 optional text of the notice * long content is allowed * see additional information format csinfo string 512 optional providers’ customer service informationusing data in json format converted to escape string * allowed items call, email, or website* see the example below applinklogo string 256 required app link image url the file size should not exceed 256 kb applinkname string 32 required app link name applinkdata string 256 required information about the partner app link bgimagestring 256 optional url for card art background image the recommended size for image resources is 888 x 555 px mainimg string 256 optional url for gift card image the file size should not exceed 512 kb bgcolor string 8 optional color of the card art e g ,#00ffff fontcolor string 8 optional color of the font on the card art acceptable values dark, light blinkcolor string 8 optional color of the blinking effect which indicates that a card cannot be captured in the indicator area e g , #00ffff barcode value string 4096 optional actual data that is delivered when the barcode/qr code is scanned barcode serialtype string 32 optional presentation type e g , serialnumber, barcode *see barcode format barcode ptformat string 32 optional presentation format e g , barcode, qrcode, serial *see barcode format barcode ptsubformat string 32 optional presentation sub-format e g , code_128, qr_code * see barcode format barcode pin string 16 optional pin to show with a barcode barcode errorcorrectionlevel string 4 optional amount of redundancy or error correction data included in the code there are four error correction levels available in qr codes * code options l/m/q/h merchantid string 36 optional merchant identifier merchantname string 32 optional merchant name to display amount string 32 optional initial balance this is going to be shown as received e g , $1,000 balance string 32 optional remaining balance this is going to be shown as received e g , $1,000 summaryurl string 256 optional web url that show details, such as balance or transactions history example { "card" { "type" "giftcard", "subtype" "others", "data" [ { "refid" "b3fdc982-28c9-47a3-b02f-d484779698a7", "createdat" 1672574400000, "updatedat" 1672574400000, "language" "en", "attributes" { "title" "samsung gift card", "eventid" "event-001", "logoimage" "https //gpp walletsvc samsung com/mcs/images/contents/wallet_intro_logo png", "logoimage darkurl" "https //gpp walletsvc samsung com/mcs/images/contents/wallet_intro_logo png", "providername" "samsung gift card provider", "user" "ms jane doe", "csinfo" "{\"call\" \"0000-0000\",\"email\" \"samsungwallet@samsungwallet com\",\"website\" \"https //www samsungwallet com/cs/\" }", "applinklogo" "https //play-lh googleusercontent com/znfa1roz7hpv9j-jiacbjmjudl2x-fnuwte0oyvbbcwvf5vpzoqqikbxgk7d-aptvag=w240-h480-rw", "applinkname" "gift card link", "applinkdata" "https //www samsung com/", "bgcolor" "#0a1a4f", "fontcolor" "light", "blinkcolor" "#00ffff", "barcode value" "cs16138353212584806754fg1802", "barcode serialtype" "qrcode", "barcode ptformat" "qrcodeserial", "barcode ptsubformat" "qr_code" } } ] } }