{"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":"This API is available only by separate agreement","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"USING A FINNISH PERSONAL ID TO CREATE A NEW INVOICE","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Calling Payment API","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"REQUEST","type":"text"},{"text":":","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 payment interface are","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"here","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012476"}}]},{"text":".","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Please note that all mandatory parameters in the generic V4 payment API are also mandatory in S2S invoice.","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","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"4204","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pmt_paymentmethod","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"FI70","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"FIIN","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pmt_token","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"< the Finnish personal ID of buyer/invoice recipient >","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pmt_invoicedistributionmethod","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"EMAIL","type":"text","marks":[{"type":"code"}]},{"text":" /","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"POST","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"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":"eaa51cc2-284d-4b55-9eb6-02962d1b53b3"}}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"RESPONSE","type":"text"},{"text":":","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Example of an OK response:","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"paragraph"},{"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 FI70\n Y\n 00\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":"paragraph","content":[{"text":"Possible result codes (","type":"text"},{"text":"pmt_resultcode","type":"text","marks":[{"type":"code"}]},{"text":") are:","type":"text"}]},{"type":"paragraph","content":[{"text":"00 = success","type":"text"}]},{"type":"paragraph","content":[{"text":"99 = fail","type":"text"}]}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"Error codes (","type":"text"},{"text":"pmt_errorcode","type":"text","marks":[{"type":"code"}]},{"text":") 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_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_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\nWAITING = Waiting for information on possible payment","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example scenarios and responses","type":"text"}]},{"type":"paragraph","content":[{"text":"When credit can not be approved:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\t99\n\tEXTERNAL_SERVICE_DENIED\n\tValittu maksupalvelu vastasi kieltävästi.\n\tRecurring FI70 invoicing failed with code=REJECTED and message=The credit report was rejected.\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Buyer’s social security number (","type":"text"},{"text":"pmt_token","type":"text","marks":[{"type":"code"}]},{"text":") is missing or null:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\t99\n\tERROR\n\tTuntematon virhe toiminnon suorittamisessa\n\tpmt_token is a mandatory field\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Buyer’s social security number (","type":"text"},{"text":"pmt_token","type":"text","marks":[{"type":"code"}]},{"text":") is erroneous:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\t99\n\tERROR_PAYMENT_INSTRUMENT_NOT_FOUND\n\tAnnettua maksuvälinettä ei löydy.\n\tError in field[pmt_token] errortext[Token not found] erroneousValue[291292-918N]\n\tToken not found\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Buyer’s email address is missing:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\t99\n\tERROR\n\tTuntematon virhe toiminnon suorittamisessa\n\tpmt_buyeremail is mandatory when payment method is pre-selected\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Buyer’s email address is erroneous:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\t99\n\tERROR\n\tTuntematon virhe toiminnon suorittamisessa\n\tSähköpostiosoite on virheellinen.\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Buyer’s address is missing:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\t99\n\tERROR\n\tTuntematon virhe toiminnon suorittamisessa\n\tOsoite puuttuu.\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Delivery address is missing:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\t99\n\tERROR\n\tTuntematon virhe toiminnon suorittamisessa\n\tToimitusosoite puuttuu.\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Buyer’s postal code is missing or erroneous:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\t99\n\tERROR\n\tTuntematon virhe toiminnon suorittamisessa\n\tPostinumero puuttuu.\n\tOstajan postinumero on virheellinen.\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Delivery postal code is missing or erroneous:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\t99\n\tERROR\n\tTuntematon virhe toiminnon suorittamisessa\n\tToimitusosoitteen postinumero on virheellinen.\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Status query for Invoice payment","type":"text"}]},{"type":"paragraph","content":[{"text":"Version 0005 of Svea Payments’ Status Query interface can be used for the status query of tokenized payments or recurring payments made with tokens. General instructions can be found in ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012569"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"TEST","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"https://test1.maksuturva.fi/PaymentStatusQuery.pmt","type":"text","marks":[{"type":"link","attrs":{"href":"https://test1.maksuturva.fi/PaymentStatusQuery.pmt"}}]}]},{"type":"paragraph","content":[{"text":"PRODUCTION","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"https://payments.maksuturva.fi/PaymentStatusQuery.pmt","type":"text","marks":[{"type":"link","attrs":{"href":"https://payments.maksuturva.fi/PaymentStatusQuery.pmt"}}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is an example of a situation, where tokenization and payment has been performed, settlement of the transaction has been made to the web store and lastly, a status query has been done:","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n PAYMENT_STATUS_QUERY\n 568,10\n N\n N\n 1234567\n 11.05.2016\n FI70\n 11.05.2016 12:45:07\n 40\n Compensated to the seller\n 5,00\n 6234567890ABCDE\n [ODLVR|Kauppiaan oma toimitus|80]\n 0005\n","type":"text"}]}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Testing","type":"text"}]},{"type":"paragraph","content":[{"text":"This API 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 ","type":"text"},{"text":"individual test credentials","type":"text","marks":[{"type":"link","attrs":{"href":"https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657014153/TESTING#Testing-with-individual-seller-credentials"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Please see ","type":"text"},{"text":"TESTING","type":"text","marks":[{"type":"link","attrs":{"href":"https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657014153"}}]},{"text":" for instructions on the authentication of payments made in test environment.","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph"}]}]}],"version":1}

Browser not supported