Petra2 Java API – SjOrderFacadeInterface.debit

Method description

Exempel på en kortbetalning.

• PaymentType Obligatoriskt fält, skall fyllas i med den betalkod som säljstället ska använda för kortköp. Kontrollera möjliga värden med metod ValidateOrder
• CardSystemData Struktur som innehåller information om på vilket sätt kortköp skall göras, när det gäller kontokortköp skall struktur CardData fyllas i.
• CardData Struktur som innehåller kontokortinformation.
• CardData.Cardnr Kortnummer, obligatoriskt fält, om kryptering används sätts detta fält till "". Detta fält kommer troligen att göras optionellt i framtiden eftersom krypterat kortnummer bör användas.
• CardData.ExpireDate Kortets tomdat, anges i form ÅÅMM.
• CardData.SignatureOnFile Optionellt fält där man kan ange om det är signaturköp eller fullmaksköp som skall användas.
• CardData. CreditCardTransactionJournalData Optionellt fält som innehåller journaldata, används endast om man redan gjort debitering mot EFT och bara skall registrera köpet i Petra (Används endast när betalningsmodellen är K2).
• CardData. TransactionJournalSpecification Optionellt struktur som används då Journaldata skall genereras på Servern (Används endast när betalningsmodellen är K8 eller K9). Används då debitering gjorts mot Paynova och man vill registrera köpet i Petra.
• CardData.HashKey Fält som innehåller MAC-resultatet av det krypterade kortnumret.
• CardData.EncryptedCardnr Krypterat kortnummer.
• CardData.CardValidationIndicator Optionellt fält för CVD-indikator, kan innehålla fäljande värden:
  • 0 = CVD bypassed
  • 1 = CVD code dvs cvdkod skall anges
  • 2 = CVD illegible dvs CVD koden är oläsbar på kort.
  • 3 = CVD no imprint, dvs CDV kod saknas på kort
• CardData.CardValidationData Själva CVD-koden
• CardData.DebitMethod Optionellt fält där man anger om kortets konto eller kredit skall belastas, K=Kredit, D=Konto.

Om betalningsmodellen för angivet betalningsmedel är K8 eller K9(Paynova) så skall nytt Journaldata genereras och sparas centralt. Servern förväntar sig då följande indata:

• TransactionJournalSpecification
• TerminalId
• BundleI

CardSystem i TransactionJournalSpecification och i TransactionJournalSpecificationFull motsvarar inlösarkod (KKINLKOD i Petra), och inte kontokortssystem (KKORTSYS i Petra).
For Javadoc, click here.

Input

DebitSpecification

DebitSpecification, struktur för debitering

Strukturen av typen DebitSpecification utgör indata för metoden debit.

• [PaymentSpecification PaymentSpecification] - Innehåller information om betalning.
  • String paymentType - Obligatoriskt fält, skall fyllas i med den betalkod som säljstället ska använda.
  • [VoucherPayment:VoucherPayment] - Innehåller information om de vouchers (värdebevis eller ombokningsbara biljetter) som ska användas för betalning.
  VoucherType
  Här anges vilken typ av voucher man tänker använda, antingen SJPConstants.VVoucherTypeVoucher för Värdebevis eller SJPConstants.VVoucherTypeExchange för ombokningsbar biljett.
  UsedVoucherList
  En lista med biljetter som ska användas som betalning.
  VoucherIdentification
  VoucherIdentification hämtas från svaret på getVoucher och är biljettnumret på den gamla biljetten.
  BasePaymentTypeItemList
  BasePaymentTypeItemList är en lista med de nya biljetterna som ska betalas med de gamla biljetterna.
  OrderItemID
  I OrderItemID anger man sedan om vilket radnummer i den nya beställningen man hänvisar till, sedan kan man med [BasePaymentTypeAmountMoney] bestämma hur mycket av den gamla biljettens pris som ska användas för betalning på just denna nya biljett.
  • [CardSystemData CardSystemData] - Struktur som innehåller information om på vilket sätt kortköp skall göras.
  • [Identity RequisitionId] - Rekvisitionsid.
  • [PaymentComplementData PaymentComplementData] - Innehåller sista giltighetsdatum för ett kontokort, används när man vill göra override på det datum som är lagrat för ett kort i Petra i de fall man själv inte fyller i kortinformation vid kortbetalning, t ex vid resekonto.
• [ExternalEventSpecification ExternalEventSpecification] - Struktur som används för att göra override på värden satta vid påloggning.
• [ReturnVatDescription boolean] Flagga som avgör om summerade belopp per momssats ska returneras.

[UsedVoucherList] och [BasePaymentSpecification:BasePaymentSpecification] har tagits bort från toppnivån och lags in i optionell struktur i [PaymentSpecification:PaymentSpecification].

Output

DebitResult

DebitResult, Svarsstruktur vid debitering

Strukturen av typen DebitResult utgör utdata för metoden credit.

• OrderDescription OrderDescription - Innehåller information om en beställning.

MoneyPayedNetAmount

MoneyPayedNetAmount visar hur mycket av biljettens pris som har betalas med "vanligt betalningsmedel", dvs. som inte kunde betalas med en ombokningsbar biljett eller värdebevis.