This API enables seamless integration with our platform, providing a comprehensive set of endpoints for account and payment management. It supports operations on both first- and second-level accounts and facilitates payment processing across multiple methods. Designed for flexibility and scalability, the API equips you with the tools necessary to optimize and automate your financial workflows.
\nThe Payment Services API acts as the primary gateway for integrating with the company's account management and payment systems.
It supports operations on first- and second-level accounts, and provides a comprehensive suite of payment solutions for both present and non-present transactions, including QR-based payments. Designed to ensure standardization, security, and operational efficiency, the API enables businesses to manage a wide range of payment scenarios seamlessly.
The solution is implemented using REST APIs over the HTTPS protocol, which ensures message encryption.
\nA successful response is indicated by a status code in the 200 range. Examples:
\n200 - OK
\n201 - OK and item created
\n202 - OK but processing not completed
\nAn error response is indicated by a status code in the 400 range. Examples:
\n400 - Bad request - Bad syntax
\n401 - Not authorized by the server
\n404 - url not found
\nAll responses are in JSON format. While the structure of a successful response may vary depending on the specific API, error responses follow a common format as outlined below:
\nHTTP Code 400s:
\n`{\n \"code\": \"401\",\n \"message\": \"Not authorized\",\n \"details\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}\n\n`curl --location 'https://api01.pvssa.com.ar/oauth2/token' \\
--data-urlencode 'grant_type=client_credentials'
All API endpoints require authentication using JWT Bearer tokens. Before making any requests, the merchant must obtain an access token by authenticating with our OAuth 2.0 token service. PVS will provide a ClientId and a ClientSecret to get the Access Token.
\nInclude the Access Token in the Authorization header of all subsequent API requests.
\nThe response will be a JSON object that follows the schema below:
\nHTTP Code 200:
\n{\n \"access_token\": \"eyJhbGciOiJSU…………..\",\n \"expires_in\": 300,\n \"refresh_expires_in\": 0,\n \"token_type\": \"Bearer\",\n \"not-before-policy\": 0,\n \"scope\": \"profile email\"\n }\n\nThis endpoint enables the creation of a QR code for present-mode payments, allowing transactions to be completed using any wallet operating in Argentina. This endpoint is exlusively for integration requests coming from outside Argentina.
\nThe response will be a JSON object following the schema below:
\nHTTP Code 200:
\n","urlObject":{"path":["external","connect","api","v1","qr","pvs-foreign"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"459d433f-ad5e-4782-8f2e-59b4c3d06b04","name":"Good Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"amount\": 200.00,\n \"externalId\": \"External TEst\",\n \"reference\": \"000-000345468765001\",\n \"currency\": \"ARS\",\n \"concept\": \"TEST CONCEPT\"\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/external/connect/api/v1/qr/pvs-foreign"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"OK\",\n \"message\": \"Operacion exitosa.\",\n \"ok\": true,\n \"data\": {\n \"qrRaw\": \"00020101021243280010ar.com.pvs0105311339901150150011202677827425204739953030325406200.005802AR5920PDV KUCH ANDRES OMAR6008NECOCHEA80360010ar.com.pvs0108672073590206COMPRA6108B6660CYI630471CE\",\n \"txeId\": 1128705,\n \"qrId\": \"pvs-31133-959759d3-2eb9-4aa6-abba-f1a9758177f6\",\n \"qrImage\": \"iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAADaklEQVR4Xu2aTY6cMBCFq8WCJUfgJs3FWgKJi9E38RFYeoGovPfMIIQiTZYuBUtDCP68qNTPq/LE/F/Wavcvf10PdlsPdlsPdlvVY8nMGrfXOqZ272bPw4q/WucpY4dE/Rh+5tR+fbPWfevtzd1hNctD2a0fy9bNyReYZoPPjgMTic3y25o4GDblLLM+v2AuDe9jYQmb7u3STWbvw3CPgznjzb987EgepIxCjclTduvHkCBNyrTv/mDuRMC04Kz182MfIs8QdOdm9Rhr1tQj1FCztN4INTyQ+tZNfQishBVZmquENxYB98XwCIBxST5mvSJvug3ywcI1oArHwBb7QPxW6/WW6Sy8WY9vI/erx5JJPhzOOpuRpKBD7f2cltaMOSXPVHFhWuP+RdAh670cCIHJSLAzc/0wEkVAhKpXBAxhpTQ3ll2Xs2B9L5tDYEiPBt8l3WsD+8iyZkkGI2B8oQI65YMaorzBUUdzOHKzfgyOmdnLNjINmx2zBQkvGYyAsT7BO1+OdIezSNBSFuAIGNN8QnrIWUU+ZnXnvQ5EwDxzU6yqcMtch8c2KWAKgdEnBmfZOV3LWXjwqiAERr1gpYICMtcRfmpBcHRnRxIAS1I7zdmUwUSM7fgxHoXAsiz9nlMpigCth36zmMXAYJnproajEENtpLBDFTm4hsA01xUF5GQkwyUfGpQiYM47Dv4BP9lPtrTF8IulVWNSQIqfS/dUrtSOK3kiYEk9ueuybGDeKN50acDzETA0tIw3KiAlD80IBusyGel8AIwpM+EF6QHfoFLttBTKkYwrAubMdU4USHjMFryrcbbjn9Kdh8CU3PjElEGiHH0IbwnosQgYxwp2fs6gg33qPpgydNUls2rG8DOh8TB2H6i96j5EmCbuABgFeyyOkeTJXMWg8zYwCsaKy2JLDaGz1CGWX0iEwFhnaenGhJ9o6VjGVRblEFi6/i4Rpkk+siqBwfoImFZRO9NsgXgznYKQXEbsijFmeKPOz8sbncV449ulJ68Zc/Wyx2DdnG92m4xqxjSaajIyXl6KhYiP/Ce4TB+1Y0kNVC56sdJZvOhQ/kfBWICPPgSfQbwoKYzBEJhT6OSYzP+gQftwihvL9a6mZsyY60U5XihXbRlNKYP75fa4Zuz39WC39WC39WC39R9hfwDE4qVN8vgobAAAAABJRU5ErkJggg==\",\n \"date\": \"30/01/2026 15:36:37\",\n \"expiration\": 180,\n \"interFinalAmount\": \"200,00\",\n \"interFinalCurrency\": \"ARS\",\n \"priceNationalCurrency\": \"200,00\",\n \"exchange\": 1.00,\n \"reference\": \"000-000345468765001\",\n \"concept\": \"Cobro por productos\"\n }\n}"},{"id":"3a30ea77-364e-4dae-a564-2eeed06c8e7d","name":"Bad Amount Format","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 200,\r\n \"reference\": \"000-000345468765001\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/external/connect/api/v1/qr/pvs-foreign"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"BAD_REQUEST\",\n \"message\": \"Check input fields.\",\n \"details\": [\n {\n \"field\": \"amount\",\n \"message\": \"Formato inválido. El número debe contener dos decimales y una coma(,) o punto(.) como separador.\"\n }\n ]\n}"},{"id":"2e2b2a03-bcd8-40a1-8168-efad85d1dc98","name":"Amount out of limits","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 200.234,\r\n \"reference\": \"000-000345468765001\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/external/connect/api/v1/qr/pvs-foreign"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"E_007\",\n \"message\": \"Monto invalido\",\n \"ok\": false\n}"},{"id":"891c3a55-5a05-4eef-a904-01a763106dbc","name":"Duplicated reference","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 200.24,\r\n \"reference\": \"000-000345468765001\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/external/connect/api/v1/qr/pvs-foreign"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"PRECONDITION_FAILED\",\n \"message\": \"El externalId ya existe\"\n}"}],"_postman_id":"27105b28-1443-4d65-a13b-bd384d033727"},{"name":"Callback Process","id":"67372aae-f5e6-4b1c-a534-b7f2d86d2abc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Accept-Language","value":"es"},{"key":"X-callback-ID","value":"PvsCallbackHeaderId","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{yourhost}}/{{yoururl}}?qr.reference=MerchantQRref","description":"The QR platform can send real-time updates about a QR code via a callback whenever a payment status changes.
This callback is triggered through a POST request to the URL specified by the client when the QR reaches a final status: either APPROVED or REJECTED. The notification will be sent to the provided URL:
{{HTTP(S)://HOST_MERCHANT}}?qr.reference=ref_qr
\nIt is important to implement the callback handler on your side without performing business logic that could delay the response to our service.
The callback should return an HTTP 200 OK response as quickly as possible, ideally by queuing the transaction into a table or database for later processing.
If the callback does not receive an HTTP 200 OK response, the platform will retry the notification up to three additional times at intervals of 3, 6, and 9 minutes, respectively.
{\n \n \"qrId\": \"pvs-35146-545sfsghew84-s4f5-s8d5-7sdgff471s5f\",\n \"reference\":\"FC A 07011-00124321\",\n \"concept\": \"Cobro por productos\",\n \"amount\":50.00,\n \"txeId\":\"422164787\",\n \"status\":\"APPROVED\",\n \"notified_at\":\"2024-10-10T18:00:23Z\",\n \"payer\":{\n \"name\":\"PEDRO GARCIA\",\n \"idType\":\"DNI\",\n \"idNumber\":\"33445989\"\n }\n}\n\nThis endpoint allows the refund of a previously paid QR - Argentina foreign mode. The parameter to reference the QR is the txeId value obtained in the QR creation. The amount in the body must match the amount of the created QR.
\nThe response will be a JSON object following the schema below:
\nHTTP Code 200:
\n","urlObject":{"path":["external","connect","api","v1","transactions","reverse","{{txeId}}"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[{"id":"8f46b9aa-aea2-451f-885e-7ed7c351023c","name":"Good Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 1001.00\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/external/connect/api/v1/transactions/reverse/{{txeId}}"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"code\": \"OK\",\r\n \"message\": \"244\",\r\n \"ok\": true\r\n}"},{"id":"184ca8a8-6396-4dc0-b8cd-be835d52af26","name":"QR Not Paid","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 1001.00\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/external/connect/api/v1/transactions/reverse/{{txeId}}"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"E_008\",\n \"message\": \"Estado invalido.\",\n \"ok\": false\n}"},{"id":"a4e12749-ca95-4870-8eb5-4088b19a8897","name":"Wrong amount","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 9999999999\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/external/connect/api/v1/transactions/reverse/{{txeId}}"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"code\": \"E_007\",\r\n \"message\": \"Monto invalido\",\r\n \"ok\": false\r\n}"}],"_postman_id":"c7882462-3eae-4e29-8323-afd3314b6341"},{"name":"ARGENTINE - Get QR Status Foreign","id":"e0107136-0cbe-4f77-8a2a-afdc7243a9f7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"url":"{{host}}/external/connect/api/v1/transactions/qrpvs-foreign/:txeId","description":"This endpoint allows you to retrieve the status of a qrId generated during the creation of a present-mode QR code Foreign mode. In this case the path variable to be used is the transaction ID received in the request of the QR (txeId).
\nThe response will be a JSON object following the schema below:
\nHTTP Code 200:
\n","urlObject":{"path":["external","connect","api","v1","transactions","qrpvs-foreign",":txeId"],"host":["{{host}}"],"query":[],"variable":[{"type":"any","value":"","key":"txeId"}]}},"response":[{"id":"8e8ec130-8289-4114-a624-4cd3a588f055","name":"Good Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"url":"{{host}}/external/connect/api/v1/transactions/qrpvs-foreign/1076585"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"OK\",\n \"ok\": true,\n \"data\": {\n \"id\": 174,\n \"productName\": \"QR Argentina\",\n \"currency\": \"PYG\",\n \"date\": \"29/10/2025 09:41:13\",\n \"stateId\": 6,\n \"state\": \"Procesando\",\n \"netAmount\": 200.00,\n \"tip\": 0.0000,\n \"amount\": 200.00,\n \"remoteId\": \"TEST PAYMENT\",\n \"defaultDataDescription\": \"\",\n \"defaultDataProd\": \"QR Argentina\",\n \"turn\": \"\",\n \"reversable\": false,\n \"operator\": \"ext-11\",\n \"payMethod\": \"\",\n \"billNumber\": \"\",\n \"details\": {\n \"concept\": \"QR PVS\"\n },\n \"voucherLinesV2\": [\n {\n \"label\": null,\n \"type\": \"label\",\n \"value\": \"Número de operación\",\n \"copy\": false\n },\n {\n \"label\": null,\n \"type\": \"string\",\n \"value\": \"174\",\n \"copy\": true\n }\n ],\n \"amountStr\": \"200,00\",\n \"supportsVoucher\": false,\n \"icon\": \"\"\n }\n}"}],"_postman_id":"e0107136-0cbe-4f77-8a2a-afdc7243a9f7"}],"id":"bd4cc604-58c5-4729-a277-1188e456411e","description":"This collection offers endpoints for generating Argentine QR code - Foreign mode across the various payment methods supported by our platform.
\nIt enables the seamless creation of region-specific QR codes for different payment networks, supporting both present and non-present payment scenarios.
\nThe currently supported QR code type is:
\nEach endpoint ensures secure integration and provides flexibility for customizing QR codes with parameters such as amount, reference, and expiration time.
\nIt features:
\nQR present mode Foreign intented to create QRs which are payed at the moment, requested from outside of Argentina's territory.
\nCallback process, to explain the message that is sent one the QR gets to a final state (Approved or rejected).
\nQR refund process.
\nGet QR status, to check for a specific QR state.
\n