{"collection":{"info":{"_postman_id":"5c6d1257-d974-40b2-8ba7-64e26ba92aa1","name":"POS API","description":"> Documentación de referencia para el uso de servicio transaccional con API POS \n  \n\nSi necesitas más referencia sobre el api puedes consultar la siguiente documentación: [api reference](https://api-docs.kushkipagos.com/docs/card-present-payments/key-exchange)\n\n### **Índice:**\n\n> 🪐 Get Started  \n📢 Recent Updates  \n🔐 Authorization  \n⏱ Rate and usage limits  \n✍️ Example Responses  \n🤔 Need Help? \n  \n\n## 🪐 **Get Started**\n\nPara inciar en el uso de tu servicio POS, necesitas:\n\n1. **Credenciales**: Una vez se ha creado tu usuario y comercio en la plataforma kushki se te van a compartir un par de llaves **public key** y **private key**, este par de llaves son las que se requieren en el payload.\n    \n2. **Access**: Llaves BDK de data y PIN, para poder realizar el encriptado de tus datos.\n    \n\n### 🤔 **Necesitas ayuda?**\n\nSi necesitas ayuda con la implementación no dudes en comunicarnos desde slack.","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json","createdAt":"2024-06-27T15:53:44.000Z","updatedAt":"2024-06-27T16:44:16.000Z","lastUpdatedBy":"15303680","uid":"15303680-5c6d1257-d974-40b2-8ba7-64e26ba92aa1"},"item":[{"name":"Transactions","item":[{"name":"transaction","id":"0c5dfa96-9c48-4d03-92ce-05f625ce9cb7","request":{"method":"POST","header":[{"key":"Private-Credential-Id","value":"{{PrivateCredentialId}}","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"amount\": {\n        \"currency\": \"MXN\",\n        \"extra_taxes\": {},\n        \"iva\": 0,\n        \"subtotal_iva\": 0,\n        \"subtotal_iva0\": 65,\n        \"tip\": 0\n    },\n    \"card\": {\n        \"card_holder_name\": \"CARD MEX\"\n    },\n    \"card_details\": {\n        \"enc_tlv\": \"D92CAEBDF1FFE2612FBE3632D802314A86F258B785AD379E47CA22EA226E2C7641F3802F1D7449D50E4483AA083E2C2B0B2FD914111EA0B9E96A694FBA49A62921FD2294AA60F43A2F731A6C1AD3346351BCC31F8C75C3DDABB578DD4FCF3630C936C448FBA02F3756FA79132268FA293B84902051F58310FFCCDFFA371EBADC6DFECD489871D6B0A017FC238EFF6ECBB83411810D706917CC5F6A363633826A7E8D8E50DE181347672E691803D6C4B08D7B27809FD2DF6F82B9EB8FF163A4E4ED10183B623C25C3\",\n        \"pin_ksn\": \"FFFF22F9AF0003A00001\",\n        \"reading_type\": \"ICC\",\n        \"tracks\": {\n            \"enc_track2\": \"02B2D14756044A5FD877074DB39D53D3E3B3F95210B5372E\",\n            \"track_ksn\": \"FFFF22F9AF0003A00001\"\n        }\n    },\n    \"client_transaction_id\": \"{{$randomUUID}}\",\n    \"contact_details\": {\n        \"document_number\": \"\",\n        \"document_type\": \"-1\",\n        \"email\": \"\",\n        \"first_name\": \"\",\n        \"last_name\": \"\",\n        \"phone_number\": \"\",\n        \"second_last_name\": \"\"\n    },\n    \"cvm_type\": \"none\",\n    \"is_cashback\": false,\n    \"is_deferred\": false,\n    \"pos_details\": {\n        \"brand\": \"SUNMI\",\n        \"has_print\": true,\n        \"location\": {\n            \"latitude\": -0.1848534,\n            \"longitude\": -78.4769761\n        },\n        \"model\": \"P2-EU\",\n        \"terminal_id\": \"PB04212424181\",\n        \"version\": \"Kushki SunmiV1.1.28\"\n    },\n    \"transaction_mode\": \"Authorization\",\n    \"transaction_type\": \"charge\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{baseUrl}}/pos/v1/transaction","host":["{{baseUrl}}"],"path":["pos","v1","transaction"]},"description":"Creates a new transaction. You can transfer funds between accounts by providing two account IDs in the `fromAccountId` and `toAccountId` fields.\n\n### Response\n\nA successful request will contain a single transaction object with the newly created transaction `id`\n\nIf there are not enough funds in the originator's account to complete the transaction, the request will return a `400 Insufficient Funds` error.\n\n### Important!\n\nTransactions cannot be edited once created, so use this endpoint with caution."},"response":[{"id":"27d8f305-d669-40d2-bd7e-ae6009f20d16","name":"Successful Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": {\n        \"currency\": \"MXN\",\n        \"extra_taxes\": {},\n        \"iva\": 0,\n        \"subtotal_iva\": 0,\n        \"subtotal_iva0\": 65,\n        \"tip\": 0\n    },\n    \"card\": {\n        \"card_holder_name\": \"CARD MEX\"\n    },\n    \"card_details\": {\n        \"enc_tlv\": \"D92CAEBDF1FFE2612FBE3632D802314A86F258B785AD379E47CA22EA226E2C7641F3802F1D7449D50E4483AA083E2C2B0B2FD914111EA0B9E96A694FBA49A62921FD2294AA60F43A2F731A6C1AD3346351BCC31F8C75C3DDABB578DD4FCF3630C936C448FBA02F3756FA79132268FA293B84902051F58310FFCCDFFA371EBADC6DFECD489871D6B0A017FC238EFF6ECBB83411810D706917CC5F6A363633826A7E8D8E50DE181347672E691803D6C4B08D7B27809FD2DF6F82B9EB8FF163A4E4ED10183B623C25C3\",\n        \"pin_ksn\": \"FFFF22F9AF0003A00001\",\n        \"reading_type\": \"ICC\",\n        \"tracks\": {\n            \"enc_track2\": \"02B2D14756044A5FD877074DB39D53D3E3B3F95210B5372E\",\n            \"track_ksn\": \"FFFF22F9AF0003A00001\"\n        }\n    },\n    \"client_transaction_id\": \"{{$randomUUID}}\",\n    \"contact_details\": {\n        \"document_number\": \"\",\n        \"document_type\": \"-1\",\n        \"email\": \"\",\n        \"first_name\": \"\",\n        \"last_name\": \"\",\n        \"phone_number\": \"\",\n        \"second_last_name\": \"\"\n    },\n    \"cvm_type\": \"none\",\n    \"is_cashback\": false,\n    \"is_deferred\": false,\n    \"pos_details\": {\n        \"brand\": \"SUNMI\",\n        \"has_print\": true,\n        \"location\": {\n            \"latitude\": -0.1848534,\n            \"longitude\": -78.4769761\n        },\n        \"model\": \"P2-EU\",\n        \"terminal_id\": \"PB04212424181\",\n        \"version\": \"Kushki SunmiV1.1.28\"\n    },\n    \"transaction_mode\": \"Authorization\",\n    \"transaction_type\": \"charge\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api-uat.kushkipagos.com/pos/v1/transaction","protocol":"https","host":["api-uat","kushkipagos","com"],"path":["pos","v1","transaction"]}},"status":"Created","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"additional_amounts\": {\n        \"account_type\": \"\",\n        \"amount\": 0,\n        \"amount_type\": \"\",\n        \"card_type\": \"\",\n        \"currency_code\": \"\"\n    },\n    \"authorized_amount\": 65,\n    \"card_type\": \"credit\",\n    \"cvm_type\": \"none\",\n    \"franchise\": \"PROSA\",\n    \"kushki_response\": {\n        \"code\": \"000\",\n        \"message\": \"Approved or completed Successfully.\"\n    },\n    \"message_fields\": {\n        \"F38\": \"223273\",\n        \"F39\": \"00\",\n        \"F55\": \"91106C3982E84D065899001200000000000071709f180441424344860d841e00000872d7d06b30fdb0df860d841e00000895609d17caff5d43860d841e000008d3b5782ce1f80b6a860d841e00000832c88ba879f5d0b4860d841e000008db4922e8ba157ae9860d841e000008ff98d27978f0577c860d841e000008a859a01deca6f384\"\n    },\n    \"transaction_reference\": \"b55f2891-324c-4054-b85b-7a6f9b408b5d\",\n    \"transaction_status\": \"APPROVAL\",\n    \"transaction_type\": \"charge\"\n}","createdAt":"2024-06-27T15:53:44.000Z","updatedAt":"2024-06-27T16:46:18.000Z","uid":"15303680-27d8f305-d669-40d2-bd7e-ae6009f20d16"},{"id":"5647a75e-57c2-4330-b8db-dd9053e4db7b","name":"Declined","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": {\n        \"currency\": \"MXN\",\n        \"extra_taxes\": {},\n        \"iva\": 0,\n        \"subtotal_iva\": 0,\n        \"subtotal_iva0\": 10,\n        \"tip\": 0\n    },\n    \"card\": {\n        \"card_holder_name\": \"CARD MEX\"\n    },\n    \"card_details\": {\n        \"enc_tlv\": \"D92CAEBDF1FFE2612FBE3632D802314A86F258B785AD379E47CA22EA226E2C7641F3802F1D7449D50E4483AA083E2C2B0B2FD914111EA0B9E96A694FBA49A62921FD2294AA60F43A2F731A6C1AD3346351BCC31F8C75C3DDABB578DD4FCF3630C936C448FBA02F3756FA79132268FA293B84902051F58310FFCCDFFA371EBADC6DFECD489871D6B0A017FC238EFF6ECBB83411810D706917CC5F6A363633826A7E8D8E50DE181347672E691803D6C4B08D7B27809FD2DF6F82B9EB8FF163A4E4ED10183B623C25C3\",\n        \"pin_ksn\": \"FFFF22F9AF0003A00001\",\n        \"reading_type\": \"ICC\",\n        \"tracks\": {\n            \"enc_track2\": \"02B2D14756044A5FD877074DB39D53D3E3B3F95210B5372E\",\n            \"track_ksn\": \"FFFF22F9AF0003A00001\"\n        }\n    },\n    \"client_transaction_id\": \"{{$randomUUID}}\",\n    \"contact_details\": {\n        \"document_number\": \"\",\n        \"document_type\": \"-1\",\n        \"email\": \"\",\n        \"first_name\": \"\",\n        \"last_name\": \"\",\n        \"phone_number\": \"\",\n        \"second_last_name\": \"\"\n    },\n    \"cvm_type\": \"none\",\n    \"is_cashback\": false,\n    \"is_deferred\": false,\n    \"pos_details\": {\n        \"brand\": \"SUNMI\",\n        \"has_print\": true,\n        \"location\": {\n            \"latitude\": -0.1848534,\n            \"longitude\": -78.4769761\n        },\n        \"model\": \"P2-EU\",\n        \"terminal_id\": \"PB04212424181\",\n        \"version\": \"Kushki SunmiV1.1.28\"\n    },\n    \"transaction_mode\": \"Authorization\",\n    \"transaction_type\": \"charge\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{baseUrl}}/api/v1/transactions","host":["{{baseUrl}}"],"path":["api","v1","transactions"]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:16:53 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"101"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n    \"additional_amounts\": {\n        \"account_type\": \"\",\n        \"amount\": 0,\n        \"amount_type\": \"\",\n        \"card_type\": \"\",\n        \"currency_code\": \"\"\n    },\n    \"authorized_amount\": 10,\n    \"card_type\": \"credit\",\n    \"cvm_type\": \"none\",\n    \"franchise\": \"PROSA\",\n    \"kushki_response\": {\n        \"code\": \"01\",\n        \"message\": \"Refer to card issuer.\"\n    },\n    \"message_fields\": {\n        \"F38\": \"198977\",\n        \"F39\": \"01\",\n        \"F55\": \"91106C3982E84D065899001200000000000071709f180441424344860d841e00000872d7d06b30fdb0df860d841e00000895609d17caff5d43860d841e000008d3b5782ce1f80b6a860d841e00000832c88ba879f5d0b4860d841e000008db4922e8ba157ae9860d841e000008ff98d27978f0577c860d841e000008a859a01deca6f384\"\n    },\n    \"transaction_reference\": \"352e775e-45cb-418d-b62e-7d533e5fc5ab\",\n    \"transaction_status\": \"DECLINED\",\n    \"transaction_type\": \"charge\"\n}","createdAt":"2024-06-27T15:53:44.000Z","updatedAt":"2024-06-27T16:46:55.000Z","uid":"15303680-5647a75e-57c2-4330-b8db-dd9053e4db7b"},{"id":"e6dd2ff4-b702-4668-af12-c0f32891f196","name":"Invalid Bin","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"amount\": {\n        \"currency\": \"MXN\",\n        \"extra_taxes\": {},\n        \"iva\": 0,\n        \"subtotal_iva\": 0,\n        \"subtotal_iva0\": 65,\n        \"tip\": 0\n    },\n    \"card\": {\n        \"card_holder_name\": \"CARD MEX\"\n    },\n    \"card_details\": {\n        \"enc_tlv\": \"4CD76D7720799972814E0D38EFA2FCFF1E480E195FDBDB9CB97E48F1A2085FC87C71A4AD8D7D3BBC5FA20B3161B02AC720C46C95C459D5E50113DC403521CF62DA0D84E10890B70A3C9BEB951677B0F4B7C6A4A069C2013F9A55FBDC43A41B6013CC7C0A6177BBBE1DD470DFEAE51BCA0D342C7154FE6E7B2DA8B5975E05031DA57C6C892C97B1C418768ECC5F02284AB6C832C42DE6FFF2BB1085FE9FB68A3F2E33CA929A501C0F4679D78AC081E6CF801229A8A5212A1D4B715D2CF846342423EC558337E4048B\",\n        \"pin_ksn\": \"FFFF22F9AF0003A00001\",\n        \"reading_type\": \"ICC\",\n        \"tracks\": {\n            \"enc_track2\": \"02B2D14756044A5FD877074DB39D53D3E3B3F95210B5372E\",\n            \"track_ksn\": \"FFFF22F9AF0003A00001\"\n        }\n    },\n    \"client_transaction_id\": \"{{$randomUUID}}\",\n    \"contact_details\": {\n        \"document_number\": \"\",\n        \"document_type\": \"-1\",\n        \"email\": \"\",\n        \"first_name\": \"\",\n        \"last_name\": \"\",\n        \"phone_number\": \"\",\n        \"second_last_name\": \"\"\n    },\n    \"cvm_type\": \"none\",\n    \"is_cashback\": false,\n    \"is_deferred\": false,\n    \"pos_details\": {\n        \"brand\": \"SUNMI\",\n        \"has_print\": true,\n        \"location\": {\n            \"latitude\": -0.1848534,\n            \"longitude\": -78.4769761\n        },\n        \"model\": \"P2-EU\",\n        \"terminal_id\": \"PB04212424181\",\n        \"version\": \"Kushki SunmiV1.1.28\"\n    },\n    \"transaction_mode\": \"Authorization\",\n    \"transaction_type\": \"charge\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{baseUrl}}/api/v1/transactions","host":["{{baseUrl}}"],"path":["api","v1","transactions"]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:21:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"95"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n    \"additional_amounts\": {\n        \"account_type\": \"\",\n        \"amount\": 0,\n        \"amount_type\": \"\",\n        \"card_type\": \"\",\n        \"currency_code\": \"\"\n    },\n    \"card_type\": \"\",\n    \"cvm_type\": \"none\",\n    \"franchise\": \"\",\n    \"kushki_response\": {\n        \"code\": \"006\",\n        \"message\": \"Card Brand Not Supported\"\n    },\n    \"message_fields\": {},\n    \"transaction_reference\": \"72d5f35c-55e9-49a5-b45d-4faf4f237db1\",\n    \"transaction_status\": \"DECLINED\",\n    \"transaction_type\": \"charge\"\n}","createdAt":"2024-06-27T15:53:44.000Z","updatedAt":"2024-06-27T21:20:46.000Z","uid":"15303680-e6dd2ff4-b702-4668-af12-c0f32891f196"},{"id":"1f649f5a-4e9b-4035-bc3a-054009b2c040","name":"Error decrypt","originalRequest":{"method":"POST","header":[{"key":"Private-Credential-Id","value":"{{PrivateCredentialId}}","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"amount\": {\n        \"currency\": \"MXN\",\n        \"extra_taxes\": {},\n        \"iva\": 0,\n        \"subtotal_iva\": 0,\n        \"subtotal_iva0\": 65,\n        \"tip\": 0\n    },\n    \"card\": {\n        \"card_holder_name\": \"CARD MEX\"\n    },\n    \"card_details\": {\n        \"enc_tlv\": \"4CD76D7720799972814E0D38EFA2FCFF1E480E195FDBDB9CB97E48F1A2085FC87C71A4AD8D7D3BBC5FA20B3161B02AC720C46C95C459D5E50113DC403521CF62DA0D84E10890B70A3C9BEB951677B0F4B7C6A4A069C2013F9A55FBDC43A41B6013CC7C0A6177BBBE1DD470DFEAE51BCA0D342C7154FE6E7B2DA8B5975E05031DA57C6C892C97B1C418768ECC5F02284AB6C832C42DE6FFF2BB1085FE9FB68A3F2E33CA929A501C0F4679D78AC081E6CF801229A8A5212A1D4B715D2CF846342423EC558337E4048\",\n        \"pin_ksn\": \"FFFF22F9AF0003A00001\",\n        \"reading_type\": \"ICC\",\n        \"tracks\": {\n            \"enc_track2\": \"02B2D14756044A5FD877074DB39D53D3E3B3F95210B5372E\",\n            \"track_ksn\": \"FFFF22F9AF0003A00001\"\n        }\n    },\n    \"client_transaction_id\": \"{{$randomUUID}}\",\n    \"contact_details\": {\n        \"document_number\": \"\",\n        \"document_type\": \"-1\",\n        \"email\": \"\",\n        \"first_name\": \"\",\n        \"last_name\": \"\",\n        \"phone_number\": \"\",\n        \"second_last_name\": \"\"\n    },\n    \"cvm_type\": \"none\",\n    \"is_cashback\": false,\n    \"is_deferred\": false,\n    \"pos_details\": {\n        \"brand\": \"SUNMI\",\n        \"has_print\": true,\n        \"location\": {\n            \"latitude\": -0.1848534,\n            \"longitude\": -78.4769761\n        },\n        \"model\": \"P2-EU\",\n        \"terminal_id\": \"PB04212424181\",\n        \"version\": \"Kushki SunmiV1.1.28\"\n    },\n    \"transaction_mode\": \"Authorization\",\n    \"transaction_type\": \"charge\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{baseUrl}}/pos/v1/transaction","host":["{{baseUrl}}"],"path":["pos","v1","transaction"]}},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n    \"code\": \"E053\",\n    \"details\": {\n        \"Origin\": \"CardDecryption\",\n        \"Message\": \"Error parsing card data\"\n    },\n    \"message\": \"Error en los datos de tarjeta.\"\n}","createdAt":"2024-06-27T21:21:11.000Z","updatedAt":"2024-06-27T21:22:25.000Z","uid":"15303680-1f649f5a-4e9b-4035-bc3a-054009b2c040"}],"createdAt":"2024-06-27T15:53:44.000Z","updatedAt":"2024-06-27T21:21:11.000Z","uid":"15303680-0c5dfa96-9c48-4d03-92ce-05f625ce9cb7"}],"id":"1631629b-23ab-4fb2-b8b9-c48e28c49ec1","description":"<img src=\"https://content.pstmn.io/2f912e6a-6eb0-410f-b74e-788c5bac6735/Q29pbi5wbmc=\" alt=\"Kushi%20pagos\" width=\"112\" height=\"130\">\n\nUna **transacción** es el movimiento de un cargo, cancelación, reembolso, preautorización y captura de una tarjeta, en esta colección podrás obervar las transacciones de tarjeta presente con terminales POS o mPOS;\n\nA continuación el listado de peticiones que puedes hacer al api...\n\n- <u>transaction</u> - Crea una nueva transacción","createdAt":"2024-06-27T15:53:44.000Z","updatedAt":"2024-06-27T16:30:44.000Z","uid":"15303680-1631629b-23ab-4fb2-b8b9-c48e28c49ec1"}],"event":[{"listen":"prerequest","script":{"id":"9b587a9b-8983-451d-8f91-27bfa3e5ab43","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"96815ba9-3a02-4672-a3bf-30d10be7e6cb","type":"text/javascript","exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://api-uat.kushkipagos.com","type":"string"},{"key":"PrivateCredentialId","value":"14b052921f8845258dbbd94ba368f443","type":"string"},{"key":"PublicCredentialId","value":"04305de2be1b449eaaf0261a0823b30b","type":"string"}]}}