{"type":"doc","content":[{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"HOX This part of Invoicing with a Finnish personal ID","type":"text"},{"type":"hardBreak"},{"text":"through Svea’s Webpay-interface is used only by separate agreement","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"USING A FINNISH PERSONAL ID TO CREATE A NEW PART PAYMENT","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"Skip to contents in this page","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"8a8ce457-d31d-46df-baaa-768154487ba0"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"e24b08f8-a836-46e2-9d9f-4fc014cbf821"}}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Get Part Payment Plans","type":"text"}]},{"type":"paragraph","content":[{"text":"The payment plans can be retrieved (using either GET or POST) from address ","type":"text"},{"text":"https://www.maksuturva.fi/GetSveaPaymentPlanInformation.pmt","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.maksuturva.fi/GetSveaPaymentPlanInformation.pmt"}}]},{"text":" (or ","type":"text"},{"text":"https://test1.maksuturva.fi/GetSveaPaymentPlanInformation.pmt","type":"text","marks":[{"type":"link","attrs":{"href":"https://test1.maksuturva.fi/GetSveaPaymentPlanInformation.pmt"}}]},{"text":" in the testing environment).","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph"},{"type":"paragraph"}]}]},{"type":"table","attrs":{"layout":"default","localId":"b48b982b-2c57-47db-9a40-ba606978614b"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#e6fcff","rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"Field","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#e6fcff","rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"Input name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#e6fcff","rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"Value","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#e6fcff","rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#e6fcff","rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"Min lenght","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#e6fcff","rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"C/O","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"Seller ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"gpp_sellerid","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"AN50","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"C","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"The total amount of the order that the buyer is about to pay, including all the costs.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"gpp_amounttotal","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"e.g. 573,10","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"AN17","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"C","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"The currency of the total amount","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"gpp_amountcurrency","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"EUR, SEK, USD","type":"text"},{"type":"hardBreak"},{"text":"default: EUR","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"A2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"O","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"Language","type":"text"},{"type":"hardBreak"},{"text":"This influences mostly error messages since the OK-response contains only numeric data.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"request_locale","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"fi, sv, en","type":"text"},{"type":"hardBreak"},{"text":"default: fi","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"A2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.0]},"content":[{"type":"paragraph","content":[{"text":"O","type":"text"}]}]}]}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"full-width"}}],"content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Response","type":"text"}]},{"type":"paragraph","content":[{"text":"The response (JSON document, UTF-8) is returned as direct response to the HTTP GET/POST request. the result contains a list of campaign objects with relevant information. For creating a S2S Part Payment, the ","type":"text"},{"text":"CampaignCode ","type":"text","marks":[{"type":"strong"}]},{"text":"value is the one you want to pass to the ","type":"text"},{"text":"Payment API","type":"text","marks":[{"type":"link","attrs":{"href":"https://sveapayments.atlassian.net/wiki/spaces/DOCSLEGACY/pages/704577538/Svea+S2S+Part+Payment#Calling-Payment-API"}}]},{"text":" request, to select that campaign.","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph"}]}]},{"type":"table","attrs":{"layout":"default","localId":"11a36dd8-e43a-4209-857d-d5c1f7a5aba6"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#e6fcff","rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"ResaultCode","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#e6fcff","rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"ResultTest","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#e6fcff","rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"00","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"SUCCESS","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"OK","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"10","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"NO_PLANS_AVAILABLE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"Usually because of too small total amount","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"99","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"ERROR","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"See below examples","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Calling Payment API","type":"text"}]},{"type":"paragraph","content":[{"text":"REQUEST:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The V4 interface is used in a ","type":"text"},{"text":"server-to-server","type":"text","marks":[{"type":"strong"}]},{"text":" type fashion. The web store transfers the payment data directly as an HTTP POST -request. The web store can choose which http client product to use for this.","type":"text"}]},{"type":"paragraph","content":[{"text":"TEST:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"http://test1.maksuturva.fi/NewChargeWithTokenActionExtended.pmt","type":"text","marks":[{"type":"link","attrs":{"href":"http://test1.maksuturva.fi/NewChargeWithTokenActionExtended.pmt"}}]}]},{"type":"paragraph","content":[{"text":"PRODUCTION:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"https://payments.maksuturva.fi/NewChargeWithTokenActionExtended.pmt","type":"text","marks":[{"type":"link","attrs":{"href":"https://payments.maksuturva.fi/NewChargeWithTokenActionExtended.pmt"}}]}]},{"type":"paragraph","content":[{"text":"The general instructions for the V4 payment interface can be found in Svea Payments’ integration guidelines: ","type":"text"},{"text":"http://docs.sveapayments.fi/api/payment-api/payment/","type":"text","marks":[{"type":"link","attrs":{"href":"http://docs.sveapayments.fi/api/payment-api/payment/"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"In the request, the version information and pre-selected payment method should have the following values in the interface information:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pmt_version=4204","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pmt_paymentmethod=FI71","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pmt_token=< ","type":"text","marks":[{"type":"strong"}]},{"text":"the Finnish personal ID of buyer/Part Payment recipient ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":">","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pmt_campaigncode=","type":"text","marks":[{"type":"strong"}]},{"text":"< selected campaign code >","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"(the value of the ","type":"text","marks":[{"type":"em"}]},{"text":"CampaignCode ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"key for the selected campaign from the result data retrieved from ","type":"text","marks":[{"type":"em"}]},{"text":"Get Part Payment Plans","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://sveapayments.atlassian.net/wiki/spaces/DOCSLEGACY/pages/704577538/Svea+S2S+Part+Payment#Get-Part-Payment-Plans"}}]},{"text":" )","type":"text","marks":[{"type":"em"}]}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"AUTHENTICATING THE REQUEST:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"You can use one of the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Hash value:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pmt_hash: Calculate hash value as described in general instructions for the V4 payment interface.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"While creating the string to be hashed, add ","type":"text"},{"text":"pmt_token","type":"text","marks":[{"type":"em"}]},{"text":" value after the ","type":"text"},{"text":"pmt_sellercosts","type":"text","marks":[{"type":"em"}]},{"text":" data","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTTP Basic Auth:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use merchant's seller_id as the username and secret key as the password for a standard HTTP Basic Auth Header.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Exclude parameters pmt_hash and pmt_hashversion from the request","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"RESPONSE:","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph"},{"type":"paragraph"}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"Example of an OK response:","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n NEW_PAYMENT_EXTENDED\n 4204\n 100000169\n 00000000001000002696\n 50,00\n EUR\n 5,00\n FI71\n Y\n 00\n **** \n","type":"text"}]}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"Example of an error response:","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n 99\n pmt_userlocale is invalid\n","type":"text"}]}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"Error codes (pmt_errorcode) for a charge made with a token or for a status query:","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"codeBlock","content":[{"text":"ALREADY_PAID = Order has already been paid\n\nERROR = Unknown error\n\nERROR_CARD_AUTHENTICATION_FAILED = 3DS authentication of card payment failed\n\nERROR_CARD_AUTHORIZATION_FAILED = Authorization of card payment failed\n\nERROR_CARD_AUTHORIZATION_TIMEOUT = Authorization or charging of card payment timed out\n\nERROR_CARD_TOKENIZATION_FAILED = Card can not be used for recurring payments\n\nERROR_IN_PAYMENT = Error in processing of payment\n\nERROR_IN_REQUEST_PAYER_DATA = Error(s) in information that can be edited by buyer \n\nERROR_IN_REQUEST_TECHNICAL_DATA = Error(s) in the technical data of the payment \n\nERROR_PAYMENT_INSTRUMENT_EXPIRED = The payment instrument is not valid\n\nERROR_PAYMENT_INSTRUMENT_LIMIT_EXCEEDED= The limit for the given payment instrument is exceeded\n\nERROR_PAYMENT_INSTRUMENT_NOT_FOUND = The given payment instrument can not be found\n\nERROR_PAYMENT_METHOD_NOT_AVAILABLE = The payment method chosen in the web store was not allowed\n\nEXTERNAL_SERVICE_DENIED = The chosen payment service denied the transaction\n\nEXTERNAL_SERVICE_ERROR = The chosen payment service gave an error response\n\nNOT_FOUND = Order can not be found\n\nPAYER_CHOSE_METHOD_AND_VANISHED = Payer chose a payment method but has not paid\n\nPAYER_INTERRUPTED = Payer cancelled the payment and returned to the web store\n\nPAYER_VANISHED = Payer vanished without paying\n\nWAITING = Waiting for information on possible payment","type":"text"}]}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Status query for Part Payment payment","type":"text"}]},{"type":"paragraph","content":[{"text":"Status queries are handled the same way as for S2S Invoice. See here for more information: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/374046721/Svea+S2S+invoice#Status-query-for-Invoice-payment"}},{"text":" ","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph"}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Hash calculation","type":"text"}]},{"type":"paragraph","content":[{"text":"General instructions for hash calculation can be found in ","type":"text"},{"text":"hash generation","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOCSLEGACY/pages/262253"}}]},{"text":" part","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Testing","type":"text"}]},{"type":"paragraph","content":[{"text":"Recurring payments can be tested in Svea Payments customer test environment (","type":"text"},{"text":"http://test1.maksuturva.fi","type":"text","marks":[{"type":"link","attrs":{"href":"http://test1.maksuturva.fi"}}]},{"text":") with personal test credentials. Instructions for ordering the credentials can be found ","type":"text"},{"text":"personal test credentials","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOCSLEGACY/pages/33238"}}]},{"text":" part","type":"text"}]},{"type":"paragraph","content":[{"text":"General instructions for integration testing can be found in ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOCSLEGACY/pages/557057"}}]},{"text":".","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph"}]}]},{"type":"paragraph"}],"version":1}

Browser not supported