Welcome to the integration API for our system. This API provides access to key functionalities that enable interaction with commerce-related data. Refer to the detailed documentation for information about available endpoints, required parameters, and expected responses.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"35146358","collectionId":"11f57ce2-24bc-4656-9d14-2567d68eb198","publishedId":"2sA3QpDEFA","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-06-18T16:02:10.000Z"},"item":[{"name":"Commerce API","item":[{"name":"Load Testing Policy","item":[],"id":"073e2b16-0e96-463a-8bb7-f1006eb6e5f3","description":"Integrators who need to perform load or stress tests on the Commerce API services must follow the procedure described below.
\nSend a request to the following contacts:
\nm.pineda@refacil.comsoportetecnico@refacil.comTests are performed under monitoring by the Cloud and IT team to prevent any impact on the platform.
\nThe certification process consists of 3 mandatory stages before an integrator can be enabled in production:
\nThe complete deck with all validation items is available at the following link:
\n\nAllows API users to log in using their credentials. This operation authenticates the user with the information provided in the request body. If the credentials are valid, an access token is issued, which must be included in subsequent requests to access protected resources on the platform. The token must be sent in the Authorization header using the Bearer prefix. The response includes the token type (Bearer) and the access token.
To prevent abuse and repeated attempts in a short period, this endpoint applies rate limiting:
\nIf these limits are exceeded, the API will temporarily reject additional calls, effectively asking the client to wait a moment before trying again.
\nThe access token expires 2 hours after it is issued, regardless of activity. Expiry is calculated from the moment of login, not from idle time. Making subsequent authenticated requests does not reset or extend the expiration window. Integrations must re-authenticate after 2 hours from the last successful login call, or treat auth errors as described in Integration guidance.
\nWhen a protected request fails because the token is invalid or expired (including after an idle timeout), the API may respond with 401 Unauthorized or 403 Forbidden (or another documented authentication error for this API). Call this login again to obtain a new token, update the Authorization header, and retry the original request once. Use a clear policy to avoid infinite loops: one login plus one retry per failed call is the standard pattern; if authentication still fails, stop retrying and investigate credentials, user blocking, or rate limits.
username (string) required - Username for authentication.
secretKey (string) required - Secret key for authentication
messageCode (string) - Code for the message.
message (string) - The message from the response.
data
tokenType (string) - Type of the token (e.g., \"Bearer\").
token (string) - Bearer access token. It expires 2 hours after being issued, regardless of activity (see Token expiration).
\n\n","urlObject":{"protocol":"{{protocol}}","path":["auth","login-api"],"host":["{{serverNameCommerceApi}}"],"query":[],"variable":[]}},"response":[{"id":"04b3acb9-da63-49cf-bbb0-13dd91c9bd38","name":"success","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"username\": \"{{username}}\",\r\n \"secretKey\": \"{{secretKey}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://{{serverNameCommerceApi}}/auth/login-api"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 19 Jun 2024 14:32:21 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"195"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"c3-TvFZVOp5oekw0MwUIGdC1tDDX3Y\""}],"cookie":[],"responseTime":null,"body":"{\n \"messageCode\": \"00\",\n \"message\": \"Operation successful.\",\n \"data\": {\n \"tokenType\": \"Bearer\",\n \"token\": \"MTcxODgwNzU0MTgwMSQyYiQxMCRHV0hJMXVpd05BQ0VXNG41bzFDL2tPQ0YyVEsxN1FvcUNhWERJaVNjRFhDNS56U2tUQWgxMg==\"\n }\n}"},{"id":"167122ed-a01e-4444-a1fa-7739db150903","name":"failed","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"username\": \"{{username}}\",\r\n \"secretKey\": \"{{secretKey}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/auth/login-api"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 19 Jun 2024 14:34:01 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"117"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"75-bCVoiQZ19yh5OQtPS8kOaKdcgDg\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"auth.invalid\",\n \"message\": \"Credenciales inválidas\",\n \"code\": \"\",\n \"timestamp\": 1718807641276\n}"},{"id":"9465607a-3d41-41b6-8c24-4a5ad7ccd157","name":"failed unauthorized","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"username\": \"{{username}}\",\r\n \"secretKey\": \"{{secretKey}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/auth/login-ap"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 19 Jun 2024 14:34:01 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"117"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"75-bCVoiQZ19yh5OQtPS8kOaKdcgDg\""}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Authentication not found.\",\n \"messageCode\": \"01\",\n \"data\": {},\n \"code\": \"string\",\n \"errorCode\": \"string\",\n \"statusCode\": 0,\n \"timestamp\": 0\n}"},{"id":"91529ba0-b7e0-462a-a509-63474638aa77","name":"failed not found","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"username\": \"{{username}}\",\r\n \"secretKey\": \"{{secretKey}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/auth/login-api"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 19 Jun 2024 14:34:01 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"117"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"75-bCVoiQZ19yh5OQtPS8kOaKdcgDg\""}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not found.\",\n \"messageCode\": \"05\",\n \"data\": {},\n \"code\": \"string\",\n \"errorCode\": \"string\",\n \"statusCode\": 0,\n \"timestamp\": 0\n}"},{"id":"9e4c6783-81d0-417f-8dcc-74ed1d3d6f3c","name":"failed internal server error","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"username\": \"{{username}}\",\r\n \"secretKey\": \"{{secretKey}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/auth/login-api"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 19 Jun 2024 14:34:01 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"117"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"75-bCVoiQZ19yh5OQtPS8kOaKdcgDg\""}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error has occurred.\",\n \"messageCode\": \"09\",\n \"data\": {},\n \"code\": \"string\",\n \"errorCode\": \"string\",\n \"statusCode\": 0,\n \"timestamp\": 0\n}"}],"_postman_id":"e95d13ed-f9cc-40f3-a25b-b8244e8cde2c"}],"id":"c2fddc1d-ab69-4bc4-90c0-879d5bc0e742","_postman_id":"c2fddc1d-ab69-4bc4-90c0-879d5bc0e742","description":""},{"name":"products","item":[{"name":"list","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript"}}],"id":"e15dda32-5bab-47b8-beab-a8fa3be1d02a","request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"url":"{{protocol}}://{{serverNameCommerceApi}}/product/list","description":"Only the first validation error is returned per request. Validation errors (400) come from the API layer; business errors (400) are returned by the authentication service.
\n
Returns the catalog of products enabled for query and sale. Internally queries the products engine and filters internal categories (bills, packages). All products returned are available for use in subsequent query and sell operations.
messageCode (string) - Response status code.message (string) - Response message.data (array)id (number) - Product or agreement identifier.categoryId (number) - Category the product belongs to.name (string) - Commercial name.needValidation (boolean) - Indicates if the product requires activation steps.moduleId (number) - Associated module in core.maxFixedTip (number) - Maximum fixed tip allowed.description (string) - Description visible to the commerce.amount (number) - Fixed amount, if applicable.sort (number) - Suggested sort order in catalogs.meta (object) - Additional metadata from the products engine.image (string) - URL of the product image.status (string) - Product status (enabled / disabled).Returns the list of configured packages (e.g., combos grouping several products). Useful for frontends that need to render hierarchies of categories → subcategories → products. Use this service to keep package data up to date.
\nmessageCode (string) - Response status code.message (string) - Response message.data (array)id (number) - Package or root category identifier.name (string) - Commercial name of the package.description (string) - Functional description.internalName (string) - Internal name used for filtering.categories (array) - List of subcategories.id (number) - Subcategory identifier.name (string) - Subcategory name.description (string) - Subcategory description.internalName (string) - Internal name of the subcategory.products (array) - Associated products (same structure as /product/list).Retrieve detailed information about the commissions associated with registered products.
\nThe response for this request is a JSON object with the following schema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"message\": {\"type\": \"string\"},\n \"messageCode\": {\"type\": \"string\"},\n \"data\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\"type\": \"number\"},\n \"name\": {\"type\": \"string\"},\n \"image\": {\"type\": \"string\"},\n \"fixedCommission\": {\"type\": \"object\"},\n \"maxFixedCommission\": {\"type\": \"number\"},\n \"commission\": {\"type\": \"number\"},\n \"commissionType\": {\"type\": \"string\"},\n \"amount\": {\"type\": \"object\"},\n \"category\": {\"type\": \"string\"},\n \"key\": {\"type\": \"string\"},\n \"overdraft\": {\"type\": \"number\"}\n }\n }\n }\n }\n}\n\nThis service provides detailed information on the categories and their subcategories.
\nThe response for this request can be documented as a JSON schema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"message\": {\n \"type\": \"string\"\n },\n \"messageCode\": {\n \"type\": \"string\"\n },\n \"data\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"products\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"categoryId\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"needValidation\": {\n \"type\": \"boolean\"\n },\n \"moduleId\": {\n \"type\": \"integer\"\n },\n \"maxFixedTip\": {\n \"type\": \"integer\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"amount\": {\n \"type\": \"integer\"\n },\n \"sort\": {\n \"type\": \"integer\"\n },\n \"meta\": {\n \"type\": \"object\"\n },\n \"image\": {\n \"type\": \"string\"\n },\n \"status\": {\n \"type\": \"string\"\n }\n },\n \"required\": [\n \"id\",\n \"categoryId\",\n \"name\",\n \"needValidation\",\n \"moduleId\",\n \"maxFixedTip\",\n \"description\",\n \"amount\",\n \"sort\",\n \"meta\",\n \"image\",\n \"status\"\n ]\n }\n }\n },\n \"required\": [\n \"id\",\n \"name\",\n \"description\",\n \"products\"\n ]\n }\n },\n \"internalName\": {\n \"type\": \"string\"\n }\n },\n \"required\": [\n \"id\",\n \"name\",\n \"description\",\n \"categories\",\n \"internalName\"\n ]\n }\n }\n },\n \"required\": [\n \"message\",\n \"messageCode\",\n \"data\"\n ]\n}\n\nAllows searching for invoice agreements on the platform using specific terms. Send the request body with the necessary parameters in the format specified by the SearchBody object. The operation returns results that match the provided search terms.
\nThe request body should be in JSON format with the following parameter:
\nquery: The search term.The response will be a JSON object with the following properties:
\nmessage: A message related to the response.
messageCode: A code related to the message.
data: An array of objects containing product information with the following properties:
id: The ID of the product.
name: The name of the product.
key: The key of the product.
productId: The ID of the product.
needsAmountInQuery: Boolean value that indicates wheter the invoice value should be include in the query.
form: Array of objects that shows me the necessary references to consult the invoice. In case it arrives empty you must send a reference of preference.
Performs the pre-sale query to obtain invoice data, reference, hash, and amount. Communicates with the Movement service. The returned hash and hashEchoData values must be forwarded in the subsequent sell request when paying bills. If the response contains only one of the two hash fields, the API automatically mirrors it to the other.
It is important that when the request fails with the errorCode product.errors.disabled or similar indicating that the product is inactive, the agreements are consulted again using the search service.
productId (number) required - Identifier of the product to query.queryType (string) required - Type of query expected by Movement (e.g., BILLData). Min length: 1.ownAgreementId (number) - Identifier of the own agreement, if applicable.data (object) - Specific provider data (reference, cellphone, etc.). Technically optional, but required by most products at the business level.reference (string) - Invoice or reference number to query. Used for bill products.cellphone (string) - Destination phone number. Used for top-ups and packages.plate (string) - Vehicle plate. Used for SOAT products.messageCode (string) - Response status code.message (string) - Response message.data (object)amount (number) - Calculated amount for the sale.productId (number) - Identifier of the queried product.productName (string) - Product name.reference (string) - Reference to be forwarded in the sell request.hash (string) - Hash generated by Movement. Mirror of hashEchoData if absent.hashEchoData (string) - Mirror hash field. Mirror of hash if absent.amountEditable (boolean) - Indicates if the amount can be modified at sell time.Allows performing a custom query on the platform. Send the request body with the necessary parameters for the query in the format specified by the QueryBody object. The response will include the results of the query in case of success.
\nRequest Body:
\nproductId (integer, required): Identifier of the product to perform the query.
queryType (string, required): The type of query to be performed.
ownAgreementId (string, optional): Identifier of the own agreement, if applicable.
data (object, required): Additional data for the query in object format.
reference (string, required): The reference for the query data.Response JSON Schema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"message\": {\n \"type\": \"string\"\n },\n \"messageCode\": {\n \"type\": \"string\"\n },\n \"data\": {\n \"type\": \"object\",\n \"properties\": {\n \"payload\": {\n \"type\": \"object\",\n \"properties\": {\n \"amount\": {\n \"type\": \"integer\"\n },\n \"productId\": {\n \"type\": \"integer\"\n },\n \"productName\": {\n \"type\": \"string\"\n },\n \"reference\": {\n \"type\": \"string\"\n },\n \"hashEchoData\": {\n \"type\": \"string\"\n },\n \"hash\": {\n \"type\": \"string\"\n },\n \"amountEditable\": {\n \"type\": \"boolean\"\n }\n }\n }\n }\n }\n }\n}\n\nAllows performing a custom query on the platform.
\nraw (application/json)
\nproductId (number, required): Identifier of the product to perform the query.
queryType (string. required): Additional data for the query in object format.
ownAgreementId (number, optional): Identifier of the own agreement, if applicable
data (object): Additional data for the query in object format.
\nThe response will include the results of the query in case of success.
\nmessage (string): The message from the response.
\nmessageCode (string): The code related to the message.
\ndata (object)
\npayload (object)
\namount (number): The amount related to the query result.
\nproductId (number): The ID of the product related to the query result.
\nproductName (string): The name of the product related to the query result.
\nreference (string): The reference related to the query result.
\nhashEchoData (string): The echoed hash data.
\nhash (string): The hash data.
\namountEditable (boolean): Indicates whether the amount is editable or not.
\ncode (string): The code from the response.
\nerrorCode (string): The error code from the response.
\nstatusCode (number): The status code from the response.
\ntimestamp (number): The timestamp of the response.
\nThis HTTP POST request is used to perform a custom query on the platform. The request body should be sent with the necessary parameters for the query in the format specified by the QueryBody object. The response will include the results of the query in case of success.
\nproductId (number) required: Identifier of the product to perform the query.
queryType (string) required: Type of query to be performed.
ownAgreementId (null): Identifier of the own agreement, if applicable.
\ndata (object) required: Additional data for the query.
required: Reference for the query.message (string): Response message.
\nmessageCode (string): Code related to the response message.
\ndata (object): Response data object.
\npayload (object): Payload data.
\namount (number): Amount related to the product.
\nproductId (number): ID of the product.
\nproductName (string): Name of the product.
\nreference (string): Reference related to the query.
\nhashEchoData (string): Hash echo data.
\nhash (string): Hash value.
\namountEditable (boolean): Indicates if the amount is editable.
\nImportant: This request will be processed within a timeout of 30,000 milliseconds (30 seconds).
\n","urlObject":{"protocol":"{{protocol}}","path":["product","query"],"host":["{{serverNameCommerceApi}}"],"query":[],"variable":[]}},"response":[{"id":"0567c65b-cccf-46aa-8da8-d173044fd68e","name":"Valid reference","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer MTcxMDQzNjY4MDkwNSQyYiQxMCRXOGtUZHlkOXVSM0FtM1puT2Vza3l1di92VnZtUTdaVGZGOWFnQUNta1NvRUxqY2c2ckJDaQ=="}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1000075,\r\n \"queryType\": \"BILLData\",\r\n \"ownAgreementId\": null,\r\n \"data\": {\r\n \"reference\": \"62540210\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 10 Jun 2024 18:14:33 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1020"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"3fc-08/BQd1GoTgQFWomzneceJEUUvU\""}],"cookie":[],"responseTime":null,"body":"{\n \"messageCode\": \"00\",\n \"message\": \"Operation successful.\",\n \"data\": {\n \"statusCode\": 200,\n \"message\": \"Successfully\",\n \"date\": 1773101286314,\n \"payload\": {\n \"amount\": 9999,\n \"productId\": 2010910,\n \"productName\": \"Facturas Otros SP\",\n \"reference\": \"63440172\",\n \"reference2\": null,\n \"hashEchoData\": \"eyJhZ3JlZW1lbnRJZCI6MzM3NDMsInJlZmVyZW5jZTEiOiI2MzQ0MDE3MiIsInJlZmVyZW5jZTIiOm51bGwsImFtb3VudCI6OTk5OSwiYWdyZWVtZW50TWVzc2FnZSI6IiIsImFncmVlbWVudENvZGUiOiIwMCIsInJlcXVpcmVzQW1vdW50IjoiMCIsImFkaXRpb25hbFZhbHVlNTRFY28iOiIwMTIzNDU2Nzg5MCIsImFkaXRpb25hbFZhbHVlNjJFY28iOiIxNTE2NTc4OTU1NjM0MjgxNjM4NzM5OTAyMjk1IiwiYWNjb3VudERhdGFBY3JlZGl0ZWQiOiI0NzU3NjY3MjA1ODE2Mzg3Mzk5MDIyOTUyMjc2IiwiYWRkaXRpb25hbENvbXBhbnlDb2RlIjoiMTUxNjU3ODk1NTYzNDI4MjgwNjI4MzcwMTIxMiIsImRhdGUiOiIyMDI2LTAzLTEwIiwidHJhY2UiOjUxMjF9\",\n \"amountEditable\": false,\n \"hash\": \"eyJhZ3JlZW1lbnRJZCI6MzM3NDMsInJlZmVyZW5jZTEiOiI2MzQ0MDE3MiIsInJlZmVyZW5jZTIiOm51bGwsImFtb3VudCI6OTk5OSwiYWdyZWVtZW50TWVzc2FnZSI6IiIsImFncmVlbWVudENvZGUiOiIwMCIsInJlcXVpcmVzQW1vdW50IjoiMCIsImFkaXRpb25hbFZhbHVlNTRFY28iOiIwMTIzNDU2Nzg5MCIsImFkaXRpb25hbFZhbHVlNjJFY28iOiIxNTE2NTc4OTU1NjM0MjgxNjM4NzM5OTAyMjk1IiwiYWNjb3VudERhdGFBY3JlZGl0ZWQiOiI0NzU3NjY3MjA1ODE2Mzg3Mzk5MDIyOTUyMjc2IiwiYWRkaXRpb25hbENvbXBhbnlDb2RlIjoiMTUxNjU3ODk1NTYzNDI4MjgwNjI4MzcwMTIxMiIsImRhdGUiOiIyMDI2LTAzLTEwIiwidHJhY2UiOjUxMjF9\"\n }\n }\n}"},{"id":"148f323d-a7a5-458c-83af-9fb02db25785","name":"Invalid reference","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer MTcxMDQzNjY4MDkwNSQyYiQxMCRXOGtUZHlkOXVSM0FtM1puT2Vza3l1di92VnZtUTdaVGZGOWFnQUNta1NvRUxqY2c2ckJDaQ=="}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1000075,\r\n \"queryType\": \"BILLData\",\r\n \"ownAgreementId\": null,\r\n \"data\": {\r\n \"reference\": \"63440172\" \r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 10 Jun 2024 18:20:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"142"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"8e-79rXl2moVmD3ZT3SgdvPXJ6Sb+U\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"Número de obligación o de factura inválido o no existe.\",\n \"timestamp\": 1718043635033\n}"},{"id":"9f1df544-cc61-4d76-9f6f-59d270162a76","name":"Reference already paid","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer MTcxMDQzNjY4MDkwNSQyYiQxMCRXOGtUZHlkOXVSM0FtM1puT2Vza3l1di92VnZtUTdaVGZGOWFnQUNta1NvRUxqY2c2ckJDaQ=="}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1000075,\r\n \"queryType\": \"BILLData\",\r\n \"ownAgreementId\": null,\r\n \"data\": {\r\n \"reference\": \"62970322\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 10 Jun 2024 18:19:47 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"111"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"6f-3dDmq8rugT3rKm4gar26pe6UYMw\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"Este pago ya fue realizado.\",\n \"timestamp\": 1718043587188\n}"}],"_postman_id":"34a1f47f-77be-4f63-beac-10ceed98cb41"},{"name":"sell","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{}}}],"id":"ea749db2-c3e9-4aec-8a42-bd7cd5e5821d","request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 9999,\r\n \"productId\": 1587,\r\n \"hash\": null,\r\n \"sellType\": \"Bill\",\r\n \"data\": {\r\n \"agreement\": 2010910,\r\n \"reference\": \"63440172\",\r\n \"cellphone\": \"3203550000\",\r\n \"hashEchoData\": \"eyJhZ3JlZW1lbnRJZCI6MzM3NDMsInJlZmVyZW5jZTEiOiI2MzQ0MDE3MiIsInJlZmVyZW5jZTIiOm51bGwsImFtb3VudCI6OTk5OSwiYWdyZWVtZW50TWVzc2FnZSI6IiIsImFncmVlbWVudENvZGUiOiIwMCIsInJlcXVpcmVzQW1vdW50IjoiMCIsImFkaXRpb25hbFZhbHVlNTRFY28iOiIwMTIzNDU2Nzg5MCIsImFkaXRpb25hbFZhbHVlNjJFY28iOiIxNTE2NTc4OTU1NjM0MjgxNjM4NzM5OTAyMjk1IiwiYWNjb3VudERhdGFBY3JlZGl0ZWQiOiI0NzU3NjY3MjA1ODE2Mzg3Mzk5MDIyOTUyMjc2IiwiYWRkaXRpb25hbENvbXBhbnlDb2RlIjoiMTUxNjU3ODk1NTYzNDI4MjgwNjI4MzcwMTIxMiIsImRhdGUiOiIyMDI2LTAzLTEwIiwidHJhY2UiOjUxMjF9\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell","description":"Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
\nNote: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
\nproductId: Number representing the product identifier (required)
amount: Number representing the amount of the payment (required)
sellType: String indicating the type of the sell operation (required)
hash: String containing the hash value for the operation (required)
data: Object containing additional data (required)
reference: String containing the reference number for the payment (required)
cellphone: String containing the cellphone number associated with the payment (required)
hashEchoData: String containing the hash echo data for the operation (required)
message: String containing a message about the operation result (required)
messageCode: String code indicating the operation result (required)
data: Object containing additional response data (required)
date: Number representing the timestamp of the operation (required)
sellId: Number representing the identifier of the sell operation (required)
payload: Object containing the main response data (required)
preBalance: Number representing the balance before the operation (required)
posBalance: Number representing the balance after the operation (required)
tmpBalance: Number representing the temporary balance (required)
debt: Number representing the debt amount (required)
billData: Object containing bill-related data (required)
fields: Array of field objects (required)
name: String representing the field name (required)
type: String representing the field type (required)
options: Array of option objects (required)
label: String representing the option label (required)
value: String representing the option value (required)
label: String representing the field label (required)
placeholder: String representing the field placeholder (required)
required: Boolean indicating if the field is required (required)
costs: Array of cost objects (required)
label: String representing the cost label (required)
value: Number representing the cost value (required)
messages: Array of message objects (required)
value: String representing the message value (required)stringInformation: Array of string information objects (required)
value: String representing the string information value (required)footerInformation: Array of footer information objects (required)
share: Object containing share information (required)
cellphone: String representing the cellphone number (required)
message: String representing the message (required)
Allows performing a custom query on the platform. Send the request body with the necessary parameters for the query in the format specified by the QueryBody object. The response will include the results of the query in case of success.
Below is an example of a request for vehicle SOAT insurance. The following necessary data must be provided: productId (in this case, 91), queryType (in this case SOATData), type of document, document number, vehicle plate, and phone number.
\nNote:
\nIt is important to remember that in the response of this product, several of its data points are crucial as they must be sent in the service that performs the sale (/sells/sell). The necessary data are as follows: amount, cifrateAmount, and hashEchoData.
\nBelow are the valid document types for the consultation process:
\nCC: Cédula de ciudadanía
\nCE: Cédula de extranjería
\nNIT: Número de identificación tributaria
\nPS: Pasaporte
\nRC: Registro civil
\nTI: Tarjeta de identidad
\nCD: Carné diplomático
\nThe following payload is required for performing a custom query:
\nqueryType: (string, required) Specifies the type of query to be performed.
productId: (number, required) Identifies the product for which the query is being made.
docType: (string, required) Specifies the type of document being used for identification.
document: (string, required) The document number for identification purposes.
cellphone: (string, required) The phone number associated with the query.
license: (string, optional) The license plate of the vehicle.
Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
Example of a payment request for the AXA Colpatria product. The necessary information is provided, such as the productId (in this case, 91) and other relevant data, all attributes are mandatory.
\nNote:
In order to sell this product, it is important to bear in mind that it is part of a special product. Therefore, before being able to use it, it is necessary to complete the entire product activation process. This can be achieved by using the following services: /product/activation/....
It is important to remember that to perform a sale using this service, several crucial data points must be sent. Some of these data points are obtained from the /products/query service. The necessary data are as follows: amount, cifrateAmount, and hashEchoData.
The following payload is required for performing a custom sell:
\nproductId: (number, required) Identifies the product for which the sale is being made.
data: (object, required) Contains specific sale data.
terminal:
id: A unique identifier for the merchant (POS) that is generating the SOAT sale transaction for the API client. If there is no merchant under the API client's network, the same merchant ID assigned by Refacil should be sent in the id field.amount: (object, required) Details about the sale amount.
amount: (number, required) Total amount of the sale.
runt: (number) Value for RUNT.
prima: (number) Prima value.
contributions: (number) Contributions.
valueDiscountLaw: (number) Value of law discount.
valueDiscountTotal: (number) Total discount value.
valuePayDiscount: (number) Amount to pay with discount.
amountAdministrative: (number) Administrative amount.
amountTotal: (number) Total amount.
dateStart: (string) Start date.
dateEnd: (string) End date.
discount: (number) Discount.
license: (string) Vehicle license plate.
hashEchoData: (string) Hash data.
cifrateAmount: (object) Encrypted amount.
hash: (string) Hash.
hashEchoData: (string) Hash data.
userDetail: (object, required) User details.
cellphone: (string, required) User's cellphone number.
email: (string) User's email.
document: (string, required) User's document number.
docType: (string, required) Type of user's document.
amount: (number, required) Total amount of the sale.
moveTmpBalance: (boolean) Indicates whether to move temporary balance.
After the sale has been successfully completed, the response will follow a structure similar to the following. In this response, important information is provided, such as the balance of the main wallet and the balance of the profit wallet. Additionally, within the 'billData' object, you will find the fundamental information necessary to generate the sales receipt that will be delivered to the end customer. It is important to note that this step is mandatory, as it is a direct requirement from AXA Colpatria.
\n","urlObject":{"protocol":"{{protocol}}","path":["sells","sell"],"host":["{{serverNameCommerceApi}}"],"query":[],"variable":[]}},"response":[{"id":"0cc34f58-c015-43c0-aa55-74c219161d2b","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 91,\r\n \"data\": {\r\n \"terminal\": {\"id\": \"123456\"},\r\n \"amount\": {\r\n \"amount\": 908800,\r\n \"runt\": 2100,\r\n \"prima\": 595900,\r\n \"contributions\": 309800,\r\n \"valueDiscountLaw\": 0,\r\n \"valueDiscountTotal\": 0,\r\n \"valuePayDiscount\": 907800,\r\n \"amountAdministrative\": 1000,\r\n \"amountTotal\": 908800,\r\n \"dateStart\": \"2024-05-28\",\r\n \"dateEnd\": \"2025-05-27\",\r\n \"discount\": 0\r\n },\r\n \"license\": \"TMY833\",\r\n \"hashEchoData\": \"eyJpZFRyYW5zYWNjaW9uIjoiZGExM2ZlZmYtOTQyMi00YzcwLTgzZjAtMjJjNmMzMTFiNDY2IiwiaWRDb3JyZWxhY2lvbiI6MTcxNjkxNTI3MjczNH0=\",\r\n \"cifrateAmount\": {\r\n \"hash\": \"eyJhbW91bnQiOjkwODgwMH0=\",\r\n \"hashEchoData\": \"ec0068253f0777fc641022340ef6c5e38342b17a468035d3e8ad5ab3876296e1641fec8fc57b048c93efb3fc2dc5c121627f15250cd27a1a8803fac7d393aec9\"\r\n },\r\n \"userDetail\": {\r\n \"cellphone\": \"3200000000\",\r\n \"email\": \"test@email.com\",\r\n \"document\": \"819000939\",\r\n \"docType\": \"NIT\"\r\n }\r\n },\r\n \"amount\": 908800\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 29 May 2024 19:50:22 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"368"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"170-UezACg3snFUqXJiSedt+vumr4jA\""}],"cookie":[],"responseTime":null,"body":"{\n \"messageCode\": \"00\",\n \"message\": \"Operation successful.\",\n \"data\": {\n \"statusCode\": 200,\n \"message\": \"Transacción Exitosa\",\n \"date\": 1716915319608,\n \"payload\": {\n \"posBalance\": \"$8,407,900.16\",\n \"tmpBalance\": \"$1,033,642.00\",\n \"billData\": {\n \"fields\": [\n {\n \"type\": \"heading\",\n \"label\": \"Recibo de venta SOAT\"\n },\n {\n \"label\": \"Código:\",\n \"value\": \"408416084\"\n },\n {\n \"label\": \"Red transacciones:\",\n \"value\": \"Super Pagos S.A.S\"\n },\n {\n \"label\": \"NIT:\",\n \"value\": \"900616155-2\"\n },\n {\n \"label\": \"Fecha y Hora:\",\n \"value\": \"2024-05-28 11:55\"\n },\n {\n \"label\": \"ID Punto de venta:\",\n \"value\": \"228757\"\n },\n {\n \"label\": \"Proveedor:\",\n \"value\": \"AXA COLPATRIA\"\n },\n {\n \"label\": \"NIT:\",\n \"value\": \"860002184-6\"\n },\n {\n \"type\": \"heading\",\n \"label\": \"Información de la póliza\"\n },\n {\n \"label\": \"Fecha expedición:\",\n \"value\": \"2024-05-28 11:55\"\n },\n {\n \"label\": \"Inicio vigencia:\",\n \"value\": \"2024-05-29 00:00\"\n },\n {\n \"label\": \"Fin Vigencia:\",\n \"value\": \"2025-05-28 23:59\"\n },\n {\n \"label\": \"No. póliza:\",\n \"value\": \"4601069500\"\n },\n {\n \"type\": \"money\",\n \"label\": \"RUNT:\",\n \"value\": \"2100\"\n },\n {\n \"type\": \"money\",\n \"label\": \"Prima SOAT:\",\n \"value\": \"595900\"\n },\n {\n \"type\": \"money\",\n \"label\": \"Contribuciones:\",\n \"value\": \"309800\"\n },\n {\n \"type\": \"money\",\n \"label\": \"Descuento de ley:\",\n \"value\": \"0\"\n },\n {\n \"type\": \"money\",\n \"label\": \"Pago total con descuento:\",\n \"value\": \"907800\"\n },\n {\n \"type\": \"heading\",\n \"label\": \"Información del tomador\"\n },\n {\n \"label\": \"Tomador:\",\n \"value\": \"INTERASEO S.A.S E.S.P\"\n },\n {\n \"label\": \"Tipo doc ID:\",\n \"value\": \"NIT 819000939\"\n },\n {\n \"label\": \"Mensaje:\",\n \"value\": \"Se solicita autorización al tomador para tratamiento de sus datos y se le informa que las políticas tratamiento de datos y la posibilidad de modificarlos o eliminarlos están en la página 222. axacolpatria.co\"\n },\n {\n \"type\": \"heading\",\n \"label\": \"Información del vehículo\"\n },\n {\n \"label\": \"Servicio:\",\n \"value\": \"Público\"\n },\n {\n \"label\": \"Cilindraje:\",\n \"value\": \"4570\"\n },\n {\n \"label\": \"Modelo:\",\n \"value\": \"2009\"\n },\n {\n \"label\": \"Placa:\",\n \"value\": \"TMY833\"\n },\n {\n \"label\": \"Marca:\",\n \"value\": \"CHEVROLET\"\n },\n {\n \"label\": \"Línea:\",\n \"value\": \"NPR\"\n },\n {\n \"label\": \"Pasajeros:\",\n \"value\": \"2\"\n },\n {\n \"label\": \"Capacidad:\",\n \"value\": \"4000\"\n },\n {\n \"label\": \"Clase:\",\n \"value\": \"CARGA O MIXTOS\"\n },\n {\n \"label\": \"No. Motor:\",\n \"value\": \"487950\"\n },\n {\n \"label\": \"No. Chasis:\",\n \"value\": \"9GDNPR7199B014109\"\n },\n {\n \"label\": \"No. VIN:\",\n \"value\": \"9GDNPR7199B014109\"\n },\n {\n \"label\": \"Mensaje 1:\",\n \"value\": \"Conserva tu recibo y descarga tu póliza en la pagina www.axacolpatria.co Las autoridades de control de transito deben verificar la tendencia del SOAT mediante una consulta en línea en tiempo real de la base del RUNT por medio de dispositivos móviles.\"\n },\n {\n \"label\": \"Mensaje 2:\",\n \"value\": \"Mayor información Comunícate en Bogotá al 601 4235757 y en el resto del país 01-8000-512620 o desde cualquier celular #247\"\n }\n ],\n \"costs\": [\n {\n \"label\": \"Administración\",\n \"value\": 1000,\n \"type\": \"money\"\n },\n {\n \"label\": \"Valor venta\",\n \"value\": 908800,\n \"type\": \"money\"\n }\n ],\n \"messages\": [\n {\n \"label\": \"Valor de descarga:\",\n \"value\": \"https://clientes.axacolpatria.co/descargar-soat\"\n }\n ],\n \"share\": {\n \"cellphone\": \"3200000000\",\n \"message\": \"¡Hola!, has comprado (SOAT AXA COLPATRIA) por valor de $908800, este es el código de la venta 408416084. A continuación podrás encontrar un link con el comprobante. https://plataforma.refacil.co/#/factura/228757/408416084\"\n }\n }\n }\n }\n}"},{"id":"ed8fa214-dab1-424e-a865-5b1908390412","name":"400 Bad Request | case 1","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 91,\r\n \"data\": {\r\n \"amount\": {\r\n \"amount\": 908800,\r\n \"runt\": 2100,\r\n \"prima\": 595900,\r\n \"contributions\": 309800,\r\n \"valueDiscountLaw\": 0,\r\n \"valueDiscountTotal\": 0,\r\n \"valuePayDiscount\": 907800,\r\n \"amountAdministrative\": 1000,\r\n \"amountTotal\": 908800,\r\n \"dateStart\": \"2024-05-28\",\r\n \"dateEnd\": \"2025-05-27\",\r\n \"discount\": 0\r\n },\r\n \"license\": \"TMY833\",\r\n \"hashEchoData\": \"eyJpZFRyYW5zYWNjaW9uIjoiZGExM2ZlZmYtOTQyMi00YzcwLTgzZjAtMjJjNmMzMTFiNDY2IiwiaWRDb3JyZWxhY2lvbiI6MTcxNjkxNTI3MjczNH0=\",\r\n \"cifrateAmount\": {\r\n \"hash\": \"eyJhbW91bnQiOjkwODgwMH0=\",\r\n \"hashEchoData\": \"ec0068253f0777fc641022340ef6c5e38342b17a468035d3e8ad5ab3876296e1641fec8fc57b048c93efb3fc2dc5c121627f15250cd27a1a8803fac7d393aec9\"\r\n },\r\n \"userDetail\": {\r\n \"cellphone\": \"3200000000\",\r\n \"email\": \"test@email.com\",\r\n \"document\": \"819000939\",\r\n \"docType\": \"NIT\"\r\n }\r\n },\r\n \"amount\": 908800\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 29 May 2024 19:50:22 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"368"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"170-UezACg3snFUqXJiSedt+vumr4jA\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"1. Se pueden realizar reintentos. 2. Si el error persiste se debe notificar a la mesa de ayuda de AXA y entregar XML o información con que están realizando la solicitud al servicio de AXA.\",\n \"timestamp\": 1717012222068,\n \"saleId\": 408416143,\n \"result\": {\n \"status\": \"error\",\n \"data\": {},\n \"message\": \"1. Se pueden realizar reintentos. 2. Si el error persiste se debe notificar a la mesa de ayuda de AXA y entregar XML o información con que están realizando la solicitud al servicio de AXA.\"\n }\n}"},{"id":"45f0a85f-3ce2-4dc9-ae1e-4414cc9cc6e0","name":"400 Bad Request | case 2","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 91,\r\n \"data\": {\r\n \"amount\": {\r\n \"amount\": 908800,\r\n \"runt\": 2100,\r\n \"prima\": 595900,\r\n \"contributions\": 309800,\r\n \"valueDiscountLaw\": 0,\r\n \"valueDiscountTotal\": 0,\r\n \"valuePayDiscount\": 907800,\r\n \"amountAdministrative\": 1000,\r\n \"amountTotal\": 908800,\r\n \"dateStart\": \"2024-05-28\",\r\n \"dateEnd\": \"2025-05-27\",\r\n \"discount\": 0\r\n },\r\n \"license\": \"TMY833\",\r\n \"hashEchoData\": \"eyJpZFRyYW5zYWNjaW9uIjoiZGExM2ZlZmYtOTQyMi00YzcwLTgzZjAtMjJjNmMzMTFiNDY2IiwiaWRDb3JyZWxhY2lvbiI6MTcxNjkxNTI3MjczNH0=\",\r\n \"cifrateAmount\": {\r\n \"hash\": \"eyJhbW91bnQiOjkwODgwMH0=\",\r\n \"hashEchoData\": \"ec0068253f0777fc641022340ef6c5e38342b17a468035d3e8ad5ab3876296e1641fec8fc57b048c93efb3fc2dc5c121627f15250cd27a1a8803fac7d393aec9\"\r\n },\r\n \"userDetail\": {\r\n \"cellphone\": \"3200000000\",\r\n \"email\": \"test@email.com\",\r\n \"document\": \"819000939\",\r\n \"docType\": \"NIT\"\r\n }\r\n },\r\n \"amount\": 908800\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 29 May 2024 19:50:22 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"368"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"170-UezACg3snFUqXJiSedt+vumr4jA\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"1.Verificar la información. 2. Garantizar que tenga una cotización del mismo día vigente. 3. Reintentar'\",\n \"timestamp\": 1717012222068,\n \"saleId\": 408416143,\n \"result\": {\n \"status\": \"error\",\n \"data\": {},\n \"message\": \"1.Verificar la información. 2. Garantizar que tenga una cotización del mismo día vigente. 3. Reintentar'\"\n }\n}"},{"id":"c47cc1a6-7edc-46d2-b054-20f3f72ad993","name":"400 Bad Request | case 3","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 91,\r\n \"data\": {\r\n \"amount\": {\r\n \"amount\": 908800,\r\n \"runt\": 2100,\r\n \"prima\": 595900,\r\n \"contributions\": 309800,\r\n \"valueDiscountLaw\": 0,\r\n \"valueDiscountTotal\": 0,\r\n \"valuePayDiscount\": 907800,\r\n \"amountAdministrative\": 1000,\r\n \"amountTotal\": 908800,\r\n \"dateStart\": \"2024-05-28\",\r\n \"dateEnd\": \"2025-05-27\",\r\n \"discount\": 0\r\n },\r\n \"license\": \"TMY833\",\r\n \"hashEchoData\": \"eyJpZFRyYW5zYWNjaW9uIjoiZGExM2ZlZmYtOTQyMi00YzcwLTgzZjAtMjJjNmMzMTFiNDY2IiwiaWRDb3JyZWxhY2lvbiI6MTcxNjkxNTI3MjczNH0=\",\r\n \"cifrateAmount\": {\r\n \"hash\": \"eyJhbW91bnQiOjkwODgwMH0=\",\r\n \"hashEchoData\": \"ec0068253f0777fc641022340ef6c5e38342b17a468035d3e8ad5ab3876296e1641fec8fc57b048c93efb3fc2dc5c121627f15250cd27a1a8803fac7d393aec9\"\r\n },\r\n \"userDetail\": {\r\n \"cellphone\": \"3200000000\",\r\n \"email\": \"test@email.com\",\r\n \"document\": \"819000939\",\r\n \"docType\": \"NIT\"\r\n }\r\n },\r\n \"amount\": 908800\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 29 May 2024 19:50:22 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"368"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"170-UezACg3snFUqXJiSedt+vumr4jA\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"1. Se pueden realizar reintentos. 2. Si el error persiste se debe notificar a la mesa de ayuda de AXA y entregar XML o información con que están realizando la solicitud al servicio de AXA\",\n \"timestamp\": 1717012222068,\n \"saleId\": 408416143,\n \"result\": {\n \"status\": \"error\",\n \"data\": {},\n \"message\": \"1. Se pueden realizar reintentos. 2. Si el error persiste se debe notificar a la mesa de ayuda de AXA y entregar XML o información con que están realizando la solicitud al servicio de AXA\"\n }\n}"}],"_postman_id":"d38fde22-2252-4774-869b-28a61e69b7af"}],"id":"7a191dba-0991-4d8f-b135-88306a4de2ef","description":"Here you will find all the endpoints related to the sale of SOAT AXA COLPATRIA.
\nNote: This product includes an administrative cost for each sale made. For more information, please contact your commercial agent.
\nFor AXA service testing: It is required to indicate in the documentation that a test environment must be requested from the commercial agent at least 15 days in advance.
\nThe following timeout values are configured for AXA provider operations:
\nImportant: These timeout values should be considered when implementing integrations with AXA COLPATRIA services to ensure proper error handling and user experience.
\n","_postman_id":"7a191dba-0991-4d8f-b135-88306a4de2ef"},{"name":"Previsora","item":[{"name":"query | Quote","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"7642aa79-794e-4bc0-ae4d-a883260049b3","request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1014006,\r\n \"documentType\": 1,\r\n \"document\": \"1032363500\",\r\n \"queryType\": \"SOATFullData\",\r\n \"license\": \"XAZ975\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query","description":"Allows performing a custom query on the platform. Send the request body with the necessary parameters for the query in the format specified by the QueryBody object. The response will include the results of the query in case of success.
The following is an example of a SOAT insurance request for a vehicle. The following required data must be provided: productId (in this case, 1014006), queryType (in this case SOATFullData), document number and vehicle registration number.
\nNote:
\nIt is important to remember that in the response of this product, several of its data points are crucial as they must be sent in the service that performs the sale (/sells/sell). The necessary data are as follows: amount, vehDetail, and userDetail.
\nThe following payload is required for performing a custom query:
\nproductId: (number, required) Identifies the product for which the query is being made.
documentType: (number, required) Specifies the type of document. Allowed values:
1: CEDULA DE CIUDADANIA2: CEDULA DE EXTRANJERIA3: NIT4: TARJETA DE IDENTIDADdocument: (string, required) The document number for identification purposes.
Length validation rules based on documentType:
For documentType = 1 (CEDULA DE CIUDADANIA):
For documentType = 2 (CEDULA DE EXTRANJERIA):
For documentType = 3 (NIT):
Additional rules based on length:
\n💡 VD (Verification Digit): A verification digit is a number mathematically calculated by DIAN (Dirección de Impuestos y Aduanas Nacionales) to validate that the NIT was entered correctly. It is included as part of the document number.\n
\nFor documentType = 4 (TARJETA DE IDENTIDAD):
queryType: (string, required) Specifies the type of query to be performed.
license: (string, required) The license plate of the vehicle.
Important: This request will be processed within a timeout of 30,000 milliseconds (30 seconds).
\n","urlObject":{"protocol":"{{protocol}}","path":["product","query"],"host":["{{serverNameCommerceApi}}"],"query":[],"variable":[]}},"response":[{"id":"790d9791-ed55-4fb0-9406-a9fd875ac77c","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1014006,\r\n \"documentType\": 1,\r\n \"document\": \"1032363500\",\r\n \"queryType\": \"SOATFullData\",\r\n \"license\": \"XAZ975\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 29 May 2024 19:28:08 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1299"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"513-SMjBTK6JYQhvQxCIRhazJt3laDU\""}],"cookie":[],"responseTime":null,"body":"{\n \"messageCode\": \"00\",\n \"message\": \"Operation successful.\",\n \"data\": {\n \"statusCode\": 200,\n \"message\": \"Successfully\",\n \"date\": 1716924224351,\n \"payload\": {\n \"license\": \"ABC123\",\n \"vehDescription\": \"NISSAN URVAN - 2012\",\n \"amount\": {\n \"TariffCode\": \"920\",\n \"InsurancePremium\": 907900,\n \"InsuranceTax\": 453950,\n \"InsuranceFine\": 1700,\n \"Total\": 1363550,\n \"TotalWithDiscountAmount\": 1363550,\n \"DiscountAmount\": 0,\n \"ElectricDiscount\": 0,\n \"PercentageElectricDiscount\": 0,\n \"InsurancePremiumFormatted\": \"$907.900\",\n \"InsuranceTaxFormatted\": \"$453.950\",\n \"InsuranceFineFormatted\": \"$1.700\",\n \"TotalFormatted\": \"$1.363.550\",\n \"DiscountAmountFormatted\": \"$0\",\n \"TotalWithDiscountAmountFormatted\": \"$1.363.550\",\n \"createdAt\": \"2020-02-20T10:23:24.000Z\",\n \"dateStart\": \"2020-02-20\",\n \"dateEnd\": \"2021-02-19\",\n \"amount\": 1413550,\n \"amountDiscount\": 0,\n \"amountOthers\": 50000,\n \"amountTotal\": 1413550,\n \"hash\": \"ba931ea8d2b57c9248ec4285c45efdddfdfff4d8\",\n \"runt\": 1700,\n \"codeFasecolda\": 0,\n \"typeCost\": 0,\n \"Law2161Discount\": 0,\n \"discount\": 0\n },\n \"vehDetail\": {\n \"vehicleLineId\": 5560,\n \"vehicleClassId\": 8,\n \"vehicleClassMinistryId\": 28,\n \"serviceTypeId\": 2,\n \"vehicleBodyTypeId\": 8,\n \"vehicleDescription\": \"NISSAN URVAN - 2012\",\n \"vehDescription\": \"NISSAN URVAN - 2012\",\n \"queryId\": \"\",\n \"noSerie\": \"\",\n \"noMotor\": \"Z0796987CM\",\n \"noChasis\": \"JN1MG4E25Z0796987\",\n \"cc\": 2953,\n \"type\": \"CERRADA\",\n \"gas\": \"\",\n \"year\": 2012,\n \"passengers\": 16,\n \"brand\": \"NISSAN\",\n \"brandId\": 64,\n \"vin\": \"JN1MG4E25Z0796987\",\n \"lineCode\": \"\",\n \"service\": \"\",\n \"zone\": \"\",\n \"weight\": 0,\n \"cityId\": 5266\n },\n \"userDetail\": {\n \"name\": \"Nombre\",\n \"lastName\": \"Apellido\",\n \"docNumber\": \"1111111\",\n \"cellphone\": \"3111111111111\",\n \"email\": \"contacto@gmail.com\",\n \"phone\": \"\",\n \"docType\": 1,\n \"address\": \"Calle 1 # 1 - 01\",\n \"cityCode\": 76834,\n \"stateCode\": 76,\n \"addressType\": 1,\n \"typePerson\": \"F\"\n }\n }\n }\n}"},{"id":"b4fa94e9-b44c-48f0-833a-a901c8cbecda","name":"No se encontró datos","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1014006,\r\n \"document\": \"1032363500\",\r\n \"queryType\": \"SOATFullData\",\r\n \"license\": \"XAZ975\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"No se encontro ningun dato: \",\n \"timestamp\": 1753988618773,\n \"path\": \"/product/query\",\n \"date\": 1753988618774\n}"},{"id":"d5315493-5ee0-40ad-a59e-695f8d67f326","name":"Placa no asociada","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1014006,\r\n \"document\": \"1032363500\",\r\n \"queryType\": \"SOATFullData\",\r\n \"license\": \"XAZ975\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"La placa no esta asociada a algun organismo de transito\",\n \"timestamp\": 1753988618773,\n \"path\": \"/product/query\",\n \"date\": 1753988618774\n}"},{"id":"8740bf68-c308-434b-a64c-67e258b240aa","name":"Timeout","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1014006,\r\n \"document\": \"1032363500\",\r\n \"queryType\": \"SOATFullData\",\r\n \"license\": \"XAZ975\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"La solicitud ha tardado mas del tiempo estimado, por favor intente nuevamente. Disculpe las molestias, agradecemos su comprension (0)\",\n \"timestamp\": 1753991481892,\n \"path\": \"/product/query\",\n \"date\": 1753991481893\n}"}],"_postman_id":"7642aa79-794e-4bc0-ae4d-a883260049b3"},{"name":"query | Consult","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{}}}],"id":"8ad11feb-8053-4f8c-ae65-2ec2cfbee3e8","request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1014006,\r\n \"queryType\": \"SOATPolicy\",\r\n \"license\": \"XAZ975\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query","description":"Returns the information of the last policy issued for the license plate. If the policy is queried on days after its issuance, the service will not return the requested information. It is important to clarify that this endpoint does not retrieve failed sales in the system.
The following payload is required for performing a custom query:
\nproductId: (number, required) Identifies the product for which the query is being made.
queryType: (string, required) Specifies the type of query to be performed, in this case have to be `SOATPolicy`.
license: (string, required) The license plate of the vehicle.
Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
Product restrictions
\nAllows selling SOAT in the name of a person who is not the owner of the vehicle.
\nSOAT can be sold for a PRIVATE CAR.
\nSOAT can be sold for a PRIVATE MOTORCYCLE.
\nSOAT can be sold for a PUBLIC SERVICE VEHICLE.
\nSOAT cannot be sold to vehicles with 0 KM.
\nSales hours are from 12:30 AM to 11:30 PM.
\nSOAT can be sold up to 30 days before its expiration.
\nThe definition of the Administrative Cost and Commission for the sale of SOAT can be validated with your Refacil Commercial Advisor.
\nThe insurance companies are directly responsible for sending the issued SOAT via email. The API provides a URL from the provider for downloading the SOAT.
\nExample of a payment request for the Previsora product. The necessary information is provided, such as the productId (in this case, 1014006) and other relevant data, all attributes are mandatory.
\nNote:
\nIt is important to remember that to perform a sale using this service, several crucial data points must be sent. Some of these data points are obtained from the /products/query Quote Service. The necessary data are as follows: amount, vehDetail, and userDetail.
Some data obtained from the /products/query service may be null; however, this data is mandatory for the sale process and must be filled in.
\nIn addition to the userDetail object, three additional attributes must be sent: gender, RegimenTypeId, and RutId.
The possible values for each of the aforementioned attributes are as follows:
\ngender:
M = Male
\nF = Female
\nRegimenTypeId:
1 = Responsible for IVA
\n2 = Not responsible for IVA
\nRutId:
1 = Large taxpayer
\n2 = Self-withholding agent
\n3 = IVA withholding agent
\n4 = Simple taxation regime
\n5 = Not applicable
\n6 = Large taxpayer-Self-withholding agent-IVA withholding agent
\n7 = Self-withholding agent-IVA withholding agent
\n8 = Large taxpayer-IVA withholding agent
\ncityCode: DANE code
stateCode: This field is populated based on the state sheet here.
To check the values for the other parameters, please refer here.
\nThe validation rules for the name and lastName fields in the userDetail object depend on the person type:
For Natural Persons (Personas Naturales):
\nMust contain only letters (uppercase and lowercase)
\nAllows letters with accents: á, é, í, ó, ú, Á, É, Í, Ó, Ú
Allows Spanish special characters: ñ, Ñ, ü, Ü
Allows spaces between words (for compound names)
\nMinimum length of 3 characters
\nDoes not allow numbers
\nDoes not allow special characters such as @, #
For Legal Entities (Personas Jurídicas):
\nAllows alphanumeric characters (letters and numbers)
\nAllows letters with accents: á, é, í, ó, ú, Á, É, Í, Ó, Ú
Allows Spanish special characters: ñ, Ñ, ü, Ü
Allows spaces between words
\nMinimum length of 3 characters
\nDoes not allow special characters such as @, #
The email field must comply with strict validation rules to prevent errors during the issuance process:
Must contain only letters and numbers (no accents or special characters like á, é, etc.)
\nAllows only single separators: . (period), _ (underscore), - (hyphen)
Cannot have consecutive separators (e.g., .. or --)
Cannot start or end with separators
\nDomain must have at least 2 characters in the top-level domain (TLD)
\nMust not contain spaces or the @ symbol except as the domain separator
Valid examples:
\nusuario@gmail.com
nombre.apellido@empresa.co
user_name@dominio.com
user-123@test.com.co
Invalid examples:
\nusuario.@gmail.com (separator at the end before @)
user..name@domain.com (consecutive separators)
@domain.com (missing local part)
usuarioá@gmail.com (contains accented characters)
campohernández@gmail.com (contains special characters with encoding issues)
johndoe@---gmail.com (multiple consecutive hyphens)
The address field must comply with the following validation rules:
A-Z, a-zá, é, í, ó, ú, Á, É, Í, Ó, Útrim(), this is effectively not possible at the start0-9#, -, ., ,Calle 123 #45-67Carrera 7 Bis #8-24Avenida Principal, Casa 5Avenida Pérez GaldósAv. Simón Bolívar 123Cl 10 Sur #45-20Urbanización La Ñora, Bloque 3The following payload is required for performing a custom sell:
\n\n\nNote: According to the provider's official documentation, the
\nnameandlastNamefields are mandatory.
productId: (number, required) Identifies the product for which the sale is being made.
data: (object, required) Contains specific sale data.
license: (string, required) License plate of the vehicle.
productId: (string, required) Product identification (empty in this example).
cellphone: (string, required) User's cellphone number.
document: (string, required) User's document number. For NIT, this field must include the verification digit and must be sent without hyphen (-).
terminal:
id: A unique identifier for the merchant (POS) that is generating the SOAT sale transaction for the API client. If there is no merchant under the API client's network, the same merchant ID assigned by Refacil should be sent in the id field.amount: (object, required) Details about the sale amount.
TariffCode: (string, required) Tariff code.
InsurancePremium: (number, required) Insurance premium.
InsuranceTax: (number, required) Insurance tax.
InsuranceFine: (number, required) Insurance fine.
Total: (number, required) Total.
TotalWithDiscountAmount: (number, required) Total with discount amount.
DiscountAmount: (number, required) Discount amount.
ElectricDiscount: (numbe, requiredr) Electric discount.
PercentageElectricDiscount: (number, required) Percentage electric discount.
InsurancePremiumFormatted: (string, required) Formatted insurance premium.
InsuranceTaxFormatted: (string, required) Formatted insurance tax.
InsuranceFineFormatted: (string, required) Formatted insurance fine.
TotalFormatted: (string, required) Formatted total.
DiscountAmountFormatted: (string, required) Formatted discount amount.
TotalWithDiscountAmountFormatted: (string, required) Formatted total with discount amount.
createdAt: (string, required) Creation date.
dateStart: (string, required) Start date.
dateEnd: (string, required) End date.
amount: (number, required) Amount.
amountDiscount: (number, required) Discount amount.
amountOthers: (number, required) Other amounts.
amountTotal: (number, required) Total amount.
hash: (string, required) Hash.
runt: (number, required) Value for RUNT.
codeFasecolda: (number, required) Fasecolda code.
typeCost: (number, required) Cost type.
Law2161Discount: (number, required) Law 2161 discount.
discount: (number, required) Discount.
vehDetail: (object) Vehicle details.
vehicleLineId: (number, required) Vehicle line ID.
vehicleClassId: (number, required) Vehicle class ID. Defined by the SAME provider (SOAT – RUNT classification). Valid values:
vehicleClassMinistryId: (number, required) Vehicle class ID (Ministry).
serviceTypeId: (number, required) Service type ID.
vehicleBodyTypeId: (number, required) Vehicle body type ID.
vehicleDescription: (string, required) Vehicle description.
vehDescription: (string, required) Vehicle description.
queryId: (string, required) Query ID.
noSerie: (string, required) Serial number.
noMotor: (string, required) Motor number. If this field is empty, it must be filled with the value from the VIN field.
noChasis: (string, required) Chassis number.
cc: (number, required) Cubic centimeters.
type: (string, required) Type.
gas: (string, required) Gas.
year: (number, required) Year.
passengers: (number, required) Passengers.
brand: (string, required) Brand.
brandId: (number, required) Brand ID.
vin: (string, required) Vehicle identification number (VIN).
lineCode: (string, required) Line code.
service: (string, required) Service.
zone: (string, required) Zone.
weight: (number, required) Weight.
cityId: (number, required) City ID.
userDetail: (object, required) User details.
name: (string) User's name.
Must have at least 3 characters and cannot contain special characters.
\nNo maximum length is configured.
\nlastName: (string, required) User's last name.
Must have at least 3 characters and cannot contain special characters.
\nNo maximum length is configured.
\ndocNumber: (string, required) User's document number.
cellphone: (string) User's cellphone number. Must be a valid Colombian cellphone number starting with \"3\" followed by exactly 9 digits (e.g., \"3001234567\").
email: (string, required) User's email. Must be a valid email address format (e.g., \"user@domain.com\").
phone: (string) User's phone.
docType: (number, required) User's document type.
address: (string, required) User's address.
cityCode: (integer, required) User's city code.
stateCode: (integer, required) User's state code.
addressType: (number, required) User's address type.
typePerson: (string) Type of person (e.g., 'F' for natural person, 'J' for legal person).
gender: (string) User's gender.
RegimenTypeId: (string, required) User's regime type ID.
RutId: (number, required) User's RUT ID.
amount: (number, required) Total amount of the sale.
moveTmpBalance: (boolean) Indicates whether to move temporary balance.
Note: If the VIN data is not available, the API will use the chassis number as a replacement.
After the sale has been successfully completed, the response will follow a structure similar to the following. This response will be returned within a timeout of 120,000 milliseconds (2 minutes). In this response, important information is provided, such as the balance of the main wallet and the balance of the profit wallet. Additionally, within the 'billData' object, you will find the fundamental information necessary to generate the sales receipt that will be delivered to the end customer.
\n","urlObject":{"protocol":"{{protocol}}","path":["sells","sell"],"host":["{{serverNameCommerceApi}}"],"query":[],"variable":[]}},"response":[{"id":"d2f0baa5-b58f-4420-873b-aebbf88a4b4f","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1014006,\r\n \"data\": {\r\n \"license\": \"ABC123\",\r\n \"productId\": 1014006,\r\n \"cellphone\": \"3001234567\",\r\n \"document\": \"1111111\",\r\n \"terminal\": {\"id\": \"123456\"},\r\n \"amount\": {\r\n \"TariffCode\": \"920\",\r\n \"InsurancePremium\": 907900,\r\n \"InsuranceTax\": 453950,\r\n \"InsuranceFine\": 1700,\r\n \"Total\": 1363550,\r\n \"TotalWithDiscountAmount\": 1363550,\r\n \"DiscountAmount\": 0,\r\n \"ElectricDiscount\": 0,\r\n \"PercentageElectricDiscount\": 0,\r\n \"InsurancePremiumFormatted\": \"$907.900\",\r\n \"InsuranceTaxFormatted\": \"$453.950\",\r\n \"InsuranceFineFormatted\": \"$1.700\",\r\n \"TotalFormatted\": \"$1.363.550\",\r\n \"DiscountAmountFormatted\": \"$0\",\r\n \"TotalWithDiscountAmountFormatted\": \"$1.363.550\",\r\n \"createdAt\": \"2020-02-20T10:23:24.000Z\",\r\n \"dateStart\": \"2020-02-20\",\r\n \"dateEnd\": \"2021-02-19\",\r\n \"amount\": 1413550,\r\n \"amountDiscount\": 0,\r\n \"amountOthers\": 50000,\r\n \"amountTotal\": 1413550,\r\n \"hash\": \"ba931ea8d2b57c9248ec4285c45efdddfdfff4d8\",\r\n \"runt\": 1700,\r\n \"codeFasecolda\": 0,\r\n \"typeCost\": 0,\r\n \"Law2161Discount\": 0,\r\n \"discount\": 0\r\n },\r\n \"vehDetail\": {\r\n \"vehicleLineId\": 5560,\r\n \"vehicleClassId\": 8,\r\n \"vehicleClassMinistryId\": 28,\r\n \"serviceTypeId\": 2,\r\n \"vehicleBodyTypeId\": 8,\r\n \"vehicleDescription\": \"NISSAN URVAN - 2012\",\r\n \"vehDescription\": \"NISSAN URVAN - 2012\",\r\n \"queryId\": \"\",\r\n \"noSerie\": \"\",\r\n \"noMotor\": \"Z0796987CM\",\r\n \"noChasis\": \"JN1MG4E25Z0796987\",\r\n \"cc\": 2953,\r\n \"type\": \"CERRADA\",\r\n \"gas\": \"\",\r\n \"year\": 2012,\r\n \"passengers\": 16,\r\n \"brand\": \"NISSAN\",\r\n \"brandId\": 64,\r\n \"vin\": \"JN1MG4E25Z0796987\",\r\n \"lineCode\": \"\",\r\n \"service\": \"\",\r\n \"zone\": \"\",\r\n \"weight\": 0,\r\n \"cityId\": 5266\r\n },\r\n \"userDetail\": {\r\n \"name\": \"Nombre\",\r\n \"lastName\": \"Apellido\",\r\n \"docNumber\": \"1111111\",\r\n \"cellphone\": \"3001234567\",\r\n \"email\": \"contacto@gmail.com\",\r\n \"phone\": \"\",\r\n \"docType\": 1,\r\n \"address\": \"Calle 1 # 1 - 01\",\r\n \"cityCode\": 76834,\r\n \"stateCode\": 76,\r\n \"addressType\": 1,\r\n \"typePerson\": \"F\",\r\n \"gender\": \"M\",\r\n \"RegimenTypeId\": \"2\",\r\n \"RutId\": 5\r\n }\r\n },\r\n \"amount\": 1413550\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 29 May 2024 19:50:22 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"368"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"170-UezACg3snFUqXJiSedt+vumr4jA\""}],"cookie":[],"responseTime":null,"body":"{\n \"messageCode\": \"00\",\n \"message\": \"Operation successful.\",\n \"data\": {\n \"statusCode\": 200,\n \"message\": \"Transacción Exitosa\",\n \"date\": 1725038661212,\n \"payload\": {\n \"posBalance\": \"$3,646,464.00\",\n \"tmpBalance\": \"$6,500.00\",\n \"debt\": 0,\n \"billData\": {\n \"fields\": [\n {\n \"label\": \"Producto\",\n \"value\": \"SOAT Previsora\"\n },\n {\n \"label\": \"Fecha:\",\n \"value\": \"2024-08-30\"\n },\n {\n \"label\": \"Hora:\",\n \"value\": \"12:24:20\"\n },\n {\n \"label\": \"Código:\",\n \"value\": 441187226\n },\n {\n \"label\": \"Código del proveedor:\",\n \"value\": \"3163\"\n },\n {\n \"label\": \"Placa\",\n \"value\": \"ABC123\",\n \"type\": null,\n \"labelLink\": null\n },\n {\n \"label\": \"Documento\",\n \"value\": \"1111111\",\n \"type\": null,\n \"labelLink\": null\n },\n {\n \"label\": \"Descarga tu SOAT\",\n \"value\": \"https://pre.transfiriendo.com:448/SOATNETSEAPI/modules/reports/temp/PolizaSoat14694400000300-1.pdf\",\n \"type\": \"link\",\n \"labelLink\": \"Descargar\"\n }\n ],\n \"costs\": [\n {\n \"label\": \"Valor prima\",\n \"value\": 907900,\n \"type\": null,\n \"labelLink\": null\n },\n {\n \"label\": \"Valor RUNT\",\n \"value\": 1700,\n \"type\": null,\n \"labelLink\": null\n },\n {\n \"label\": \"Contribuciones\",\n \"value\": 453950,\n \"type\": null,\n \"labelLink\": null\n },\n {\n \"label\": \"Valor descuento ley\",\n \"value\": 0,\n \"type\": null,\n \"labelLink\": null\n },\n {\n \"label\": \"Valor descuento vehículo eléctrico\",\n \"value\": 0,\n \"type\": null,\n \"labelLink\": null\n },\n {\n \"label\": \"Valor total con descuento\",\n \"value\": 1363550,\n \"type\": null,\n \"labelLink\": null\n },\n {\n \"label\": \"Administración\",\n \"value\": 50000,\n \"type\": null,\n \"labelLink\": null\n },\n {\n \"label\": \"Total\",\n \"value\": 1413550,\n \"type\": null,\n \"labelLink\": null\n }\n ],\n \"messages\": [\n {\n \"value\": \"¡Hola!, has comprado (SOAT Previsora)\"\n }\n ],\n \"links\": [\n {\n \"label\": \"Descarga Póliza\",\n \"value\": \"https://pre.seguros.transfiriendo.com:451/SoatNetPRE/Modules/Reports/PrinterInsurancePolicy.aspx?ReportName=PolicyVirtualPREVISORA&P1=4388E7176876B9B2CF56BFA2E028B10BCE8F74FF&P2=67410&P3=tucarpeta\",\n \"type\": \"link\",\n \"labelLink\": \"Descargar\"\n }\n ],\n \"share\": {\n \"cellphone\": \"3001234567\",\n \"message\": \"¡Hola!, has comprado (SOAT Previsora) por valor de $1413550, este es el código de la venta 441187226. A continuación podrás encontrar un link con el comprobante. https://plataforma.refacil.co/#/factura/348024/441187226\"\n }\n },\n \"sale\": {\n \"id\": 441187226,\n \"userId\": 348024,\n \"amount\": 1413550,\n \"serviceNumber\": \"ABC123\",\n \"status\": 1,\n \"productId\": 1014006,\n \"createdAt\": \"2024-08-30T17:24:20.000Z\",\n \"transactionId\": \"3163\",\n \"extra\": \"https://pre.transfiriendo.com:448/SOATNETSEAPI/modules/reports/temp/PolizaSoat14694400000300-1.pdf\"\n }\n }\n }\n}"},{"id":"386e7466-7f80-4a7b-903b-c14e69c90dca","name":"Timeout","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1014006,\r\n \"data\": {\r\n \"license\": \"ABC123\",\r\n \"productId\": 1014006,\r\n \"cellphone\": \"3001234567\",\r\n \"document\": \"1111111\",\r\n \"terminal\": {\"id\": \"123456\"},\r\n \"amount\": {\r\n \"TariffCode\": \"920\",\r\n \"InsurancePremium\": 907900,\r\n \"InsuranceTax\": 453950,\r\n \"InsuranceFine\": 1700,\r\n \"Total\": 1363550,\r\n \"TotalWithDiscountAmount\": 1363550,\r\n \"DiscountAmount\": 0,\r\n \"ElectricDiscount\": 0,\r\n \"PercentageElectricDiscount\": 0,\r\n \"InsurancePremiumFormatted\": \"$907.900\",\r\n \"InsuranceTaxFormatted\": \"$453.950\",\r\n \"InsuranceFineFormatted\": \"$1.700\",\r\n \"TotalFormatted\": \"$1.363.550\",\r\n \"DiscountAmountFormatted\": \"$0\",\r\n \"TotalWithDiscountAmountFormatted\": \"$1.363.550\",\r\n \"createdAt\": \"2020-02-20T10:23:24.000Z\",\r\n \"dateStart\": \"2020-02-20\",\r\n \"dateEnd\": \"2021-02-19\",\r\n \"amount\": 1413550,\r\n \"amountDiscount\": 0,\r\n \"amountOthers\": 50000,\r\n \"amountTotal\": 1413550,\r\n \"hash\": \"ba931ea8d2b57c9248ec4285c45efdddfdfff4d8\",\r\n \"runt\": 1700,\r\n \"codeFasecolda\": 0,\r\n \"typeCost\": 0,\r\n \"Law2161Discount\": 0,\r\n \"discount\": 0\r\n },\r\n \"vehDetail\": {\r\n \"vehicleLineId\": 5560,\r\n \"vehicleClassId\": 8,\r\n \"vehicleClassMinistryId\": 28,\r\n \"serviceTypeId\": 2,\r\n \"vehicleBodyTypeId\": 8,\r\n \"vehicleDescription\": \"NISSAN URVAN - 2012\",\r\n \"vehDescription\": \"NISSAN URVAN - 2012\",\r\n \"queryId\": \"\",\r\n \"noSerie\": \"\",\r\n \"noMotor\": \"Z0796987CM\",\r\n \"noChasis\": \"JN1MG4E25Z0796987\",\r\n \"cc\": 2953,\r\n \"type\": \"CERRADA\",\r\n \"gas\": \"\",\r\n \"year\": 2012,\r\n \"passengers\": 16,\r\n \"brand\": \"NISSAN\",\r\n \"brandId\": 64,\r\n \"vin\": \"JN1MG4E25Z0796987\",\r\n \"lineCode\": \"\",\r\n \"service\": \"\",\r\n \"zone\": \"\",\r\n \"weight\": 0,\r\n \"cityId\": 5266\r\n },\r\n \"userDetail\": {\r\n \"name\": \"Nombre\",\r\n \"lastName\": \"Apellido\",\r\n \"docNumber\": \"1111111\",\r\n \"cellphone\": \"3001234567\",\r\n \"email\": \"contacto@gmail.com\",\r\n \"phone\": \"\",\r\n \"docType\": 1,\r\n \"address\": \"Calle 1 # 1 - 01\",\r\n \"cityCode\": 76834,\r\n \"stateCode\": 76,\r\n \"addressType\": 1,\r\n \"typePerson\": \"F\",\r\n \"gender\": \"M\",\r\n \"RegimenTypeId\": \"2\",\r\n \"RutId\": 5\r\n }\r\n },\r\n \"amount\": 1413550\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 500,\n \"errorCode\": \"\",\n \"message\": \"Tiempo máximo excedido, por favor intente de nuevo.\",\n \"timestamp\": 1751043506902,\n \"path\": \"/sells/sell\",\n \"date\": 1751043506903\n}"},{"id":"2a300b71-6a6e-4b2b-a4b3-b7c4ead04a0c","name":"Dirección inválida","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1014006,\r\n \"data\": {\r\n \"license\": \"ABC123\",\r\n \"productId\": 1014006,\r\n \"cellphone\": \"3001234567\",\r\n \"document\": \"1111111\",\r\n \"terminal\": {\"id\": \"123456\"},\r\n \"amount\": {\r\n \"TariffCode\": \"920\",\r\n \"InsurancePremium\": 907900,\r\n \"InsuranceTax\": 453950,\r\n \"InsuranceFine\": 1700,\r\n \"Total\": 1363550,\r\n \"TotalWithDiscountAmount\": 1363550,\r\n \"DiscountAmount\": 0,\r\n \"ElectricDiscount\": 0,\r\n \"PercentageElectricDiscount\": 0,\r\n \"InsurancePremiumFormatted\": \"$907.900\",\r\n \"InsuranceTaxFormatted\": \"$453.950\",\r\n \"InsuranceFineFormatted\": \"$1.700\",\r\n \"TotalFormatted\": \"$1.363.550\",\r\n \"DiscountAmountFormatted\": \"$0\",\r\n \"TotalWithDiscountAmountFormatted\": \"$1.363.550\",\r\n \"createdAt\": \"2020-02-20T10:23:24.000Z\",\r\n \"dateStart\": \"2020-02-20\",\r\n \"dateEnd\": \"2021-02-19\",\r\n \"amount\": 1413550,\r\n \"amountDiscount\": 0,\r\n \"amountOthers\": 50000,\r\n \"amountTotal\": 1413550,\r\n \"hash\": \"ba931ea8d2b57c9248ec4285c45efdddfdfff4d8\",\r\n \"runt\": 1700,\r\n \"codeFasecolda\": 0,\r\n \"typeCost\": 0,\r\n \"Law2161Discount\": 0,\r\n \"discount\": 0\r\n },\r\n \"vehDetail\": {\r\n \"vehicleLineId\": 5560,\r\n \"vehicleClassId\": 8,\r\n \"vehicleClassMinistryId\": 28,\r\n \"serviceTypeId\": 2,\r\n \"vehicleBodyTypeId\": 8,\r\n \"vehicleDescription\": \"NISSAN URVAN - 2012\",\r\n \"vehDescription\": \"NISSAN URVAN - 2012\",\r\n \"queryId\": \"\",\r\n \"noSerie\": \"\",\r\n \"noMotor\": \"Z0796987CM\",\r\n \"noChasis\": \"JN1MG4E25Z0796987\",\r\n \"cc\": 2953,\r\n \"type\": \"CERRADA\",\r\n \"gas\": \"\",\r\n \"year\": 2012,\r\n \"passengers\": 16,\r\n \"brand\": \"NISSAN\",\r\n \"brandId\": 64,\r\n \"vin\": \"JN1MG4E25Z0796987\",\r\n \"lineCode\": \"\",\r\n \"service\": \"\",\r\n \"zone\": \"\",\r\n \"weight\": 0,\r\n \"cityId\": 5266\r\n },\r\n \"userDetail\": {\r\n \"name\": \"Nombre\",\r\n \"lastName\": \"Apellido\",\r\n \"docNumber\": \"1111111\",\r\n \"cellphone\": \"3001234567\",\r\n \"email\": \"contacto@gmail.com\",\r\n \"phone\": \"\",\r\n \"docType\": 1,\r\n \"address\": \"Calle 1 # 1 - 01\",\r\n \"cityCode\": 76834,\r\n \"stateCode\": 76,\r\n \"addressType\": 1,\r\n \"typePerson\": \"F\",\r\n \"gender\": \"M\",\r\n \"RegimenTypeId\": \"2\",\r\n \"RutId\": 5\r\n }\r\n },\r\n \"amount\": 1413550\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 500,\n \"errorCode\": \"\",\n \"message\": \"La Dirección del Tomador es inválida.\",\n \"timestamp\": 1753991476046,\n \"path\": \"/sells/sell\",\n \"date\": 1753991476047\n}"},{"id":"f163615a-21ef-4d6c-a45f-a006479cfcdb","name":"No es posible emitir","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1014006,\r\n \"data\": {\r\n \"license\": \"ABC123\",\r\n \"productId\": 1014006,\r\n \"cellphone\": \"3001234567\",\r\n \"document\": \"1111111\",\r\n \"terminal\": {\"id\": \"123456\"},\r\n \"amount\": {\r\n \"TariffCode\": \"920\",\r\n \"InsurancePremium\": 907900,\r\n \"InsuranceTax\": 453950,\r\n \"InsuranceFine\": 1700,\r\n \"Total\": 1363550,\r\n \"TotalWithDiscountAmount\": 1363550,\r\n \"DiscountAmount\": 0,\r\n \"ElectricDiscount\": 0,\r\n \"PercentageElectricDiscount\": 0,\r\n \"InsurancePremiumFormatted\": \"$907.900\",\r\n \"InsuranceTaxFormatted\": \"$453.950\",\r\n \"InsuranceFineFormatted\": \"$1.700\",\r\n \"TotalFormatted\": \"$1.363.550\",\r\n \"DiscountAmountFormatted\": \"$0\",\r\n \"TotalWithDiscountAmountFormatted\": \"$1.363.550\",\r\n \"createdAt\": \"2020-02-20T10:23:24.000Z\",\r\n \"dateStart\": \"2020-02-20\",\r\n \"dateEnd\": \"2021-02-19\",\r\n \"amount\": 1413550,\r\n \"amountDiscount\": 0,\r\n \"amountOthers\": 50000,\r\n \"amountTotal\": 1413550,\r\n \"hash\": \"ba931ea8d2b57c9248ec4285c45efdddfdfff4d8\",\r\n \"runt\": 1700,\r\n \"codeFasecolda\": 0,\r\n \"typeCost\": 0,\r\n \"Law2161Discount\": 0,\r\n \"discount\": 0\r\n },\r\n \"vehDetail\": {\r\n \"vehicleLineId\": 5560,\r\n \"vehicleClassId\": 8,\r\n \"vehicleClassMinistryId\": 28,\r\n \"serviceTypeId\": 2,\r\n \"vehicleBodyTypeId\": 8,\r\n \"vehicleDescription\": \"NISSAN URVAN - 2012\",\r\n \"vehDescription\": \"NISSAN URVAN - 2012\",\r\n \"queryId\": \"\",\r\n \"noSerie\": \"\",\r\n \"noMotor\": \"Z0796987CM\",\r\n \"noChasis\": \"JN1MG4E25Z0796987\",\r\n \"cc\": 2953,\r\n \"type\": \"CERRADA\",\r\n \"gas\": \"\",\r\n \"year\": 2012,\r\n \"passengers\": 16,\r\n \"brand\": \"NISSAN\",\r\n \"brandId\": 64,\r\n \"vin\": \"JN1MG4E25Z0796987\",\r\n \"lineCode\": \"\",\r\n \"service\": \"\",\r\n \"zone\": \"\",\r\n \"weight\": 0,\r\n \"cityId\": 5266\r\n },\r\n \"userDetail\": {\r\n \"name\": \"Nombre\",\r\n \"lastName\": \"Apellido\",\r\n \"docNumber\": \"1111111\",\r\n \"cellphone\": \"3001234567\",\r\n \"email\": \"contacto@gmail.com\",\r\n \"phone\": \"\",\r\n \"docType\": 1,\r\n \"address\": \"Calle 1 # 1 - 01\",\r\n \"cityCode\": 76834,\r\n \"stateCode\": 76,\r\n \"addressType\": 1,\r\n \"typePerson\": \"F\",\r\n \"gender\": \"M\",\r\n \"RegimenTypeId\": \"2\",\r\n \"RutId\": 5\r\n }\r\n },\r\n \"amount\": 1413550\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 500,\n \"errorCode\": \"\",\n \"message\": \"No es posible emitir la Póliza entre las fechas [20/03/2026 12:00:00 a. m. - 19/03/2027 11:59:00 p. m.]. Esto puede ser debido a que el rango de fechas es inválido o se está intentando emitir una nueva póliza con inicio posterior a los 30 días a partir de la fecha de hoy o usted posee una póliza vigente y el sistema no esta permitiendo la operación para el rango indicado.\",\n \"timestamp\": 1753924274128,\n \"path\": \"/sells/sell\",\n \"date\": 1753924274129\n}"}],"_postman_id":"1098489b-68a3-44b9-8632-c76531ff24ed"}],"id":"834ed1af-8ae7-4157-a8c9-c9f1162faf10","description":"Here you will find all the endpoints related to the sale of SOAT PREVISORA.
\nThe following timeout values are configured for PREVISORA provider operations:
\nImportant:
\nBased on the current operation of the insurance company PREVISORA, the waiting time (timeout) for sales processing has been adjusted to 5 minutes (300 seconds). This change addresses the need to ensure that all transactions are processed correctly, even in scenarios where delays may occur.
\nIn addition, the API guarantees up to 2 automatic retries in case a timeout occurs during processing. Although this behavior is not common in the API solution, it has been implemented to ensure the continuity and success of sales operations.
\nIt is recommended to take this configuration into account when implementing integrations with PREVISORA services, in order to ensure proper error handling and an optimal user experience.
\nTo test error scenarios and different response types, the following vehicle license plates are available:
\nTest Plates: Use the provided test plates to simulate different scenarios during development and testing
\nError Simulation: TIM001 and ERR-prefixed plates are specifically designed to test error handling
\nSuccess Flows: ABC123 generally represents successful operations across different methods
\nEdge Cases: ABC124-ABC127 cover various business scenarios including discounts and restrictions
\nThere is a complementary file containing additional test scenarios not listed in this documentation. You can access it here: Additional Test Scenarios Folder
\nAllows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
\nNote: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
\nImportant: This response will be returned within a timeout of 60,000 milliseconds (60 seconds).
\n","urlObject":{"protocol":"{{protocol}}","path":["sells","sell"],"host":["{{serverNameCommerceApi}}"],"query":[],"variable":[]}},"response":[{"id":"eb09eebd-9d64-420f-a850-176a824fa5ab","name":"success","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 603,\r\n \"amount\": 100,\r\n \"data\": {\r\n \"cellphone\": \"3200000000\",\r\n \"document\": \"1023900000\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 12 Sep 2024 13:14:32 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1155"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"483-TwfFNOgycNScFNppUUx02YOKAJU\""}],"cookie":[],"responseTime":null,"body":"{\n \"messageCode\": \"00\",\n \"message\": \"Operation successful.\",\n \"data\": {\n \"statusCode\": 200,\n \"message\": \"Transacción Exitosa\",\n \"date\": 1726146872944,\n \"payload\": {\n \"posBalance\": \"$100.00\",\n \"tmpBalance\": \"$0.00\",\n \"debt\": 0,\n \"billData\": {\n \"fields\": [\n {\n \"label\": \"Producto\",\n \"value\": \"RushBet\"\n },\n {\n \"label\": \"Fecha:\",\n \"value\": \"2024-09-12\"\n },\n {\n \"label\": \"Hora:\",\n \"value\": \"08:14:32\"\n },\n {\n \"label\": \"Código:\",\n \"value\": 441187621\n },\n {\n \"label\": \"Código del proveedor:\",\n \"value\": \"165768903944695\"\n },\n {\n \"label\": \"Número\",\n \"value\": \"3200000000\",\n \"type\": null,\n \"labelLink\": null\n },\n {\n \"label\": \"Transacción\",\n \"value\": \"165768903944695\",\n \"type\": null,\n \"labelLink\": null\n }\n ],\n \"costs\": [\n {\n \"label\": \"Valor base\",\n \"value\": 16807,\n \"type\": null,\n \"labelLink\": null\n },\n {\n \"label\": \"Valor iva\",\n \"value\": 3193,\n \"type\": null,\n \"labelLink\": null\n },\n {\n \"label\": \"Valor venta\",\n \"value\": 20000,\n \"type\": null,\n \"labelLink\": null\n }\n ],\n \"messages\": [\n {\n \"value\": \"data.share.message\"\n }\n ],\n \"share\": {\n \"cellphone\": null,\n \"message\": \"¡Hola!, has comprado (RushBet) por valor de $100, este es el código de la venta 441187621. A continuación podrás encontrar un link con el comprobante. https://plataforma.refacil.co/#/factura/348212/441187621\"\n }\n },\n \"sale\": {\n \"id\": 441187621,\n \"userId\": 348212,\n \"amount\": 100,\n \"serviceNumber\": \"1023900000\",\n \"status\": 1,\n \"productId\": 603,\n \"createdAt\": \"2024-09-12T13:14:32.000Z\",\n \"transactionId\": \"165768903944695\",\n \"extra\": 31070\n }\n }\n }\n}"},{"id":"b600db86-e3fd-4b99-8d04-d104532dd6ad","name":"failed bad request","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 52683,\r\n \"amount\": 50600,\r\n \"sellType\": \"Bill\",\r\n \"hash\": \"{{hash}}\",\r\n \"data\": {\r\n \"reference\": \"123456\",\r\n \"cellphone\": \"3203557642\",\r\n \"hashEchoData\": \"{{hashEchoData}}\"\r\n }\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Bad request.\",\r\n \"messageCode\": \"04\",\r\n \"data\": {},\r\n \"code\": \"string\",\r\n \"errorCode\": \"string\",\r\n \"statusCode\": 0,\r\n \"timestamp\": 0\r\n}"},{"id":"1b0bb4e3-2131-487a-a81a-ec2b82db6d13","name":"failed unauthorized","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 52683,\r\n \"amount\": 50600,\r\n \"sellType\": \"Bill\",\r\n \"hash\": \"{{hash}}\",\r\n \"data\": {\r\n \"reference\": \"123456\",\r\n \"cellphone\": \"3203557642\",\r\n \"hashEchoData\": \"{{hashEchoData}}\"\r\n }\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Authentication not found.\",\r\n \"messageCode\": \"01\",\r\n \"data\": {},\r\n \"code\": \"string\",\r\n \"errorCode\": \"string\",\r\n \"statusCode\": 0,\r\n \"timestamp\": 0\r\n}"},{"id":"9dec4c58-0080-4eab-a628-8d9ff84eb4d7","name":"failed not found","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 52683,\r\n \"amount\": 50600,\r\n \"sellType\": \"Bill\",\r\n \"hash\": \"{{hash}}\",\r\n \"data\": {\r\n \"reference\": \"123456\",\r\n \"cellphone\": \"3203557642\",\r\n \"hashEchoData\": \"{{hashEchoData}}\"\r\n }\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Not found.\",\r\n \"messageCode\": \"05\",\r\n \"data\": {},\r\n \"code\": \"string\",\r\n \"errorCode\": \"string\",\r\n \"statusCode\": 0,\r\n \"timestamp\": 0\r\n}"},{"id":"fa99fd86-8053-4b2b-ac6a-1b2fb29d0df5","name":"failed internal server error","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 52683,\r\n \"amount\": 50600,\r\n \"sellType\": \"Bill\",\r\n \"hash\": \"{{hash}}\",\r\n \"data\": {\r\n \"reference\": \"123456\",\r\n \"cellphone\": \"3203557642\",\r\n \"hashEchoData\": \"{{hashEchoData}}\"\r\n }\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"An unexpected error has occurred.\",\r\n \"messageCode\": \"09\",\r\n \"data\": {},\r\n \"code\": \"string\",\r\n \"errorCode\": \"string\",\r\n \"statusCode\": 0,\r\n \"timestamp\": 0\r\n}"},{"id":"91157c9a-016d-4ecb-b909-cab2c8387ca3","name":"failed luck and chance error","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 52683,\r\n \"amount\": 50600,\r\n \"sellType\": \"Bill\",\r\n \"hash\": \"{{hash}}\",\r\n \"data\": {\r\n \"reference\": \"123456\",\r\n \"cellphone\": \"3203557642\",\r\n \"hashEchoData\": \"{{hashEchoData}}\"\r\n }\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Error al procesar la solicitud para Luck And Chance\"\r\n}"},{"id":"e5d052ef-2461-40a3-baa3-fd1f9053ec79","name":"failed luck and chance unauthorized","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 52683,\r\n \"amount\": 50600,\r\n \"sellType\": \"Bill\",\r\n \"hash\": \"{{hash}}\",\r\n \"data\": {\r\n \"reference\": \"123456\",\r\n \"cellphone\": \"3203557642\",\r\n \"hashEchoData\": \"{{hashEchoData}}\"\r\n }\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"No autorizado para realizar la venta de Luck And Chance\"\r\n}"}],"_postman_id":"658cd0d1-09fc-4d8c-8a0c-7990ebed9c45"}],"id":"0ff9df81-0376-4e98-b054-960de470ca3d","_postman_id":"0ff9df81-0376-4e98-b054-960de470ca3d","description":""}],"id":"d54a48ae-54b8-4825-83cc-2c2a33788db4","description":"In accordance with Decree 0175 of February 14, 2025, issued by the Colombian Government, the collection of IVA tax is mandatory for sales in the Luck and Chance category.
\n","_postman_id":"d54a48ae-54b8-4825-83cc-2c2a33788db4"},{"name":"Packages","item":[{"name":"Packages Claro","item":[{"name":"sell | Packages Claro","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{}}}],"id":"bc5eb0f0-b3ef-40fc-a5f9-d7f134dc4b66","request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 200048,\r\n \"data\": {\r\n \"cellphone\": \"3215302000\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell","description":"Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
\nNote: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
\nImportant: This response will be returned within a timeout of 60,000 milliseconds (60 seconds).
\n","urlObject":{"protocol":"{{protocol}}","path":["sells","sell"],"host":["{{serverNameCommerceApi}}"],"query":[],"variable":[]}},"response":[{"id":"8dee5020-dc4d-4265-878c-9b01c4ede88c","name":"success","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 200034,\r\n \"data\": {\r\n \"cellphone\": \"3215302000\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 12 Sep 2024 13:46:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1262"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"4ee-jAFUfKLQzM1rNybMkUBOF63mHlQ\""}],"cookie":[],"responseTime":null,"body":"{\n \"messageCode\": \"00\",\n \"message\": \"Operation successful.\",\n \"data\": {\n \"statusCode\": 200,\n \"message\": \"Transacción Exitosa\",\n \"date\": 1726148788835,\n \"payload\": {\n \"posBalance\": \"$9,996,000.00\",\n \"tmpBalance\": \"$2.50\",\n \"debt\": 0,\n \"billData\": {\n \"fields\": [\n {\n \"label\": \"Producto\",\n \"value\": \"TODO INCLUIDO 400MB /MIN ILIM Y SMS A TODO OPERADOR NACIONAL + \\\"Chat de WhatsApp\"\n },\n {\n \"label\": \"Fecha:\",\n \"value\": \"2024-09-12\"\n },\n {\n \"label\": \"Hora:\",\n \"value\": \"08:46:28\"\n },\n {\n \"label\": \"Código:\",\n \"value\": 441187622\n },\n {\n \"label\": \"Código del proveedor:\",\n \"value\": \"0.a9hdjev94s\"\n },\n {\n \"label\": \"Número\",\n \"value\": \"3215302000\",\n \"type\": null,\n \"labelLink\": null\n }\n ],\n \"costs\": [\n {\n \"label\": \"Valor venta\",\n \"value\": 4000,\n \"type\": null,\n \"labelLink\": null\n }\n ],\n \"messages\": [\n {\n \"value\": \"Recarga valida por el operador\"\n }\n ],\n \"share\": {\n \"cellphone\": \"3222901435\",\n \"message\": \"¡Hola!, has comprado (TODO INCLUIDO 400MB /MIN ILIM Y SMS A TODO OPERADOR NACIONAL + \\\"Chat de WhatsApp) por valor de $4000, este es el código de la venta 441187622. A continuación podrás encontrar un link con el comprobante. https://plataforma.refacil.co/#/factura/348212/441187622\"\n }\n },\n \"sale\": {\n \"id\": 441187622,\n \"userId\": 348212,\n \"amount\": 4000,\n \"serviceNumber\": \"3215302000\",\n \"status\": 1,\n \"productId\": 52,\n \"createdAt\": \"2024-09-12T13:46:28.000Z\",\n \"transactionId\": \"0.a9hdjev94s\",\n \"extra\": \"QUJERS1FRkhJLTEyMzQ1\"\n }\n }\n }\n}"},{"id":"49cdd628-420d-44d5-8761-54b3f4f810a0","name":"failed bad request","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 52683,\r\n \"amount\": 50600,\r\n \"sellType\": \"Bill\",\r\n \"hash\": \"{{hash}}\",\r\n \"data\": {\r\n \"reference\": \"123456\",\r\n \"cellphone\": \"3203557642\",\r\n \"hashEchoData\": \"{{hashEchoData}}\"\r\n }\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Bad request.\",\r\n \"messageCode\": \"04\",\r\n \"data\": {},\r\n \"code\": \"string\",\r\n \"errorCode\": \"string\",\r\n \"statusCode\": 0,\r\n \"timestamp\": 0\r\n}"},{"id":"daa932f7-3f72-4342-bbe7-d4d1e8bb9dbc","name":"failed unauthorized","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 52683,\r\n \"amount\": 50600,\r\n \"sellType\": \"Bill\",\r\n \"hash\": \"{{hash}}\",\r\n \"data\": {\r\n \"reference\": \"123456\",\r\n \"cellphone\": \"3203557642\",\r\n \"hashEchoData\": \"{{hashEchoData}}\"\r\n }\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Authentication not found.\",\r\n \"messageCode\": \"01\",\r\n \"data\": {},\r\n \"code\": \"string\",\r\n \"errorCode\": \"string\",\r\n \"statusCode\": 0,\r\n \"timestamp\": 0\r\n}"},{"id":"5a2f41a8-aa55-4008-bf83-dccead89de1d","name":"failed not found","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 52683,\r\n \"amount\": 50600,\r\n \"sellType\": \"Bill\",\r\n \"hash\": \"{{hash}}\",\r\n \"data\": {\r\n \"reference\": \"123456\",\r\n \"cellphone\": \"3203557642\",\r\n \"hashEchoData\": \"{{hashEchoData}}\"\r\n }\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Not found.\",\r\n \"messageCode\": \"05\",\r\n \"data\": {},\r\n \"code\": \"string\",\r\n \"errorCode\": \"string\",\r\n \"statusCode\": 0,\r\n \"timestamp\": 0\r\n}"},{"id":"374bb7e1-5123-4161-b5db-aeee69d3ace1","name":"failed internal server error","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 52683,\r\n \"amount\": 50600,\r\n \"sellType\": \"Bill\",\r\n \"hash\": \"{{hash}}\",\r\n \"data\": {\r\n \"reference\": \"123456\",\r\n \"cellphone\": \"3203557642\",\r\n \"hashEchoData\": \"{{hashEchoData}}\"\r\n }\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"An unexpected error has occurred.\",\r\n \"messageCode\": \"09\",\r\n \"data\": {},\r\n \"code\": \"string\",\r\n \"errorCode\": \"string\",\r\n \"statusCode\": 0,\r\n \"timestamp\": 0\r\n}"},{"id":"dc5195af-c6c3-4867-9868-967031174794","name":"failed luck and chance error","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 52683,\r\n \"amount\": 50600,\r\n \"sellType\": \"Bill\",\r\n \"hash\": \"{{hash}}\",\r\n \"data\": {\r\n \"reference\": \"123456\",\r\n \"cellphone\": \"3203557642\",\r\n \"hashEchoData\": \"{{hashEchoData}}\"\r\n }\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Error al procesar la solicitud para Luck And Chance\"\r\n}"},{"id":"5f48927a-2ce5-4005-8e39-ae0b0efb922f","name":"failed luck and chance unauthorized","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 52683,\r\n \"amount\": 50600,\r\n \"sellType\": \"Bill\",\r\n \"hash\": \"{{hash}}\",\r\n \"data\": {\r\n \"reference\": \"123456\",\r\n \"cellphone\": \"3203557642\",\r\n \"hashEchoData\": \"{{hashEchoData}}\"\r\n }\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"No autorizado para realizar la venta de Luck And Chance\"\r\n}"}],"_postman_id":"bc5eb0f0-b3ef-40fc-a5f9-d7f134dc4b66"}],"id":"94edec1a-0135-4f3a-a99e-fab70add0b75","_postman_id":"94edec1a-0135-4f3a-a99e-fab70add0b75","description":""}],"id":"ff3c6474-ca42-44b4-8d44-b6d36991270a","_postman_id":"ff3c6474-ca42-44b4-8d44-b6d36991270a","description":""},{"name":"Recharges","item":[{"name":"DirectTV","item":[{"name":"Product | DirectTV Prepago","id":"f720737c-0682-4616-bd6c-2475f49634d4","request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"cellphone\": \"3015874044\"\r\n },\r\n \"productId\": 50,\r\n \"amount\": 1000\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell","description":"Allows performing a bill payment operation on the platform. Send the request body with the necessary parameters for the payment in the format specified by the PaymentBody object. The response will include the results of the operation in case of success.
\nproductId: Number representing the product identifier (required)
amount: Number representing the amount of the payment (required)
data: Object containing additional data (required)
cellphone: String containing the cellphone number (required)message: String containing a message about the operation result (required)
messageCode: String code indicating the operation result (required)
data: Object containing additional response data (required)
date: Number representing the timestamp of the operation (required)
sellId: Number representing the identifier of the sell operation (required)
payload: Object containing the main response data (required)
preBalance: Number representing the balance before the operation (required)
posBalance: Number representing the balance after the operation (required)
tmpBalance: Number representing the temporary balance (required)
debt: Number representing the debt amount (required)
billData: Object containing bill-related data (required)
fields: Array of field objects (required)
name: String representing the field name (required)
type: String representing the field type (required)
options: Array of option objects (required)
label: String representing the option label (required)
value: String representing the option value (required)
label: String representing the field label (required)
placeholder: String representing the field placeholder (required)
required: Boolean indicating if the field is required (required)
costs: Array of cost objects (required)
label: String representing the cost label (required)
value: Number representing the cost value (required)
messages: Array of message objects (required)
value: String representing the message value (required)stringInformation: Array of string information objects (required)
value: String representing the string information value (required)footerInformation: Array of footer information objects (required)
share: Object containing share information (required)
cellphone: String representing the cellphone number (required)
message: String representing the message (required)
Important: This response will be returned within a timeout of 60,000 milliseconds (60 seconds).
\n","urlObject":{"protocol":"{{protocol}}","path":["sells","sell"],"host":["{{serverNameCommerceApi}}"],"query":[],"variable":[]}},"response":[{"id":"b8b2ef75-c314-4d0d-aa02-f08793b9cac7","name":"success","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"cellphone\": \"3015874044\"\r\n },\r\n \"productId\": 50,\r\n \"amount\": 1000\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Operation successful.\",\r\n \"messageCode\": \"00\",\r\n \"data\": {\r\n \"date\": 0,\r\n \"sellId\": 0,\r\n \"payload\": {\r\n \"preBalance\": 0,\r\n \"posBalance\": 0,\r\n \"tmpBalance\": 0,\r\n \"debt\": 0,\r\n \"billData\": {\r\n \"fields\": [\r\n {\r\n \"name\": \"string\",\r\n \"type\": \"string\",\r\n \"options\": [\r\n {\r\n \"label\": \"string\",\r\n \"value\": \"string\"\r\n }\r\n ],\r\n \"label\": \"string\",\r\n \"placeholder\": \"string\",\r\n \"required\": true\r\n }\r\n ],\r\n \"costs\": [\r\n {\r\n \"label\": \"string\",\r\n \"value\": 0\r\n }\r\n ],\r\n \"messages\": [\r\n {\r\n \"value\": \"string\"\r\n }\r\n ],\r\n \"stringInformation\": [\r\n {\r\n \"value\": \"string\"\r\n }\r\n ],\r\n \"footerInformation\": [\r\n {}\r\n ],\r\n \"share\": {\r\n \"cellphone\": \"string\",\r\n \"message\": \"string\"\r\n }\r\n }\r\n }\r\n }\r\n}"},{"id":"2b5a0cdf-886c-475d-9e9f-9697ff4ef0b8","name":"failed not found","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"cellphone\": \"3015874044\"\r\n },\r\n \"productId\": 50,\r\n \"amount\": 1000\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Not found.\",\r\n \"messageCode\": \"05\",\r\n \"data\": {},\r\n \"code\": \"string\",\r\n \"errorCode\": \"string\",\r\n \"statusCode\": 0,\r\n \"timestamp\": 0\r\n}"},{"id":"f3b69144-bd2c-48c2-8faf-d89487b03d31","name":"failed luck and chance unauthorized","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"cellphone\": \"3015874044\"\r\n },\r\n \"productId\": 50,\r\n \"amount\": 1000\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"No autorizado para realizar la venta de Luck And Chance\"\r\n}"},{"id":"94e98c63-d3a8-49a5-9830-b2bbb256309e","name":"failed unauthorized","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"cellphone\": \"3015874044\"\r\n },\r\n \"productId\": 50,\r\n \"amount\": 1000\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Authentication not found.\",\r\n \"messageCode\": \"01\",\r\n \"data\": {},\r\n \"code\": \"string\",\r\n \"errorCode\": \"string\",\r\n \"statusCode\": 0,\r\n \"timestamp\": 0\r\n}"},{"id":"8d3f0ff8-cd09-4536-8ee4-badc5f24b0d5","name":"failed luck and chance error","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"cellphone\": \"3015874044\"\r\n },\r\n \"productId\": 50,\r\n \"amount\": 1000\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Error al procesar la solicitud para Luck And Chance\"\r\n}"},{"id":"8b9fc47a-5fdf-4167-9cfe-a678113e3a21","name":"failed bad request","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"cellphone\": \"3015874044\"\r\n },\r\n \"productId\": 50,\r\n \"amount\": 1000\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Bad request.\",\r\n \"messageCode\": \"04\",\r\n \"data\": {},\r\n \"code\": \"string\",\r\n \"errorCode\": \"string\",\r\n \"statusCode\": 0,\r\n \"timestamp\": 0\r\n}"},{"id":"40e64196-1933-4cb3-98dc-6fe7bb56634d","name":"failed internal server error","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"cellphone\": \"3015874044\"\r\n },\r\n \"productId\": 50,\r\n \"amount\": 1000\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"An unexpected error has occurred.\",\r\n \"messageCode\": \"09\",\r\n \"data\": {},\r\n \"code\": \"string\",\r\n \"errorCode\": \"string\",\r\n \"statusCode\": 0,\r\n \"timestamp\": 0\r\n}"}],"_postman_id":"f720737c-0682-4616-bd6c-2475f49634d4"}],"id":"69a38d73-4cc3-4ebb-a10e-4a7e396cb9b0","_postman_id":"69a38d73-4cc3-4ebb-a10e-4a7e396cb9b0","description":""}],"id":"98ed5f78-4f43-41b9-8ecf-d951b6503664","_postman_id":"98ed5f78-4f43-41b9-8ecf-d951b6503664","description":""},{"name":"Sale Pines","item":[{"name":"Pines","item":[{"name":"Netflix","item":[{"name":"sell | Netflix","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{}}}],"id":"eb4f1975-d190-4f0c-9924-12661db351ad","request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 202,\r\n \"amount\": 50,\r\n \"data\": {\r\n \"cellphone\": \"3015874029\",\r\n \"email\": \"correo@refacil.com\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell","description":"Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
\nNote: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
\nproductId: Number representing the product identifier (required)
amount: Number representing the amount for the transaction (required)
data: Object containing additional data (required)
cellphone: String containing the cellphone number (required)
email: String containing the email address (required)
message: String containing a message about the operation result (required)
messageCode: String code indicating the operation result (required)
data: Object containing additional response data (required)
date: Number representing the timestamp of the operation (required)
sellId: Number representing the identifier of the sell operation (required)
payload: Object containing the main response data (required)
preBalance: Number representing the balance before the operation (required)
posBalance: Number representing the balance after the operation (required)
tmpBalance: Number representing the temporary balance (required)
debt: Number representing the debt amount (required)
billData: Object containing bill-related data (required)
fields: Array of field objects (required)
name: String representing the field name (required)
type: String representing the field type (required)
options: Array of option objects (required)
label: String representing the option label (required)
value: String representing the option value (required)
label: String representing the field label (required)
placeholder: String representing the field placeholder (required)
required: Boolean indicating if the field is required (required)
costs: Array of cost objects (required)
label: String representing the cost label (required)
value: Number representing the cost value (required)
messages: Array of message objects (required)
value: String representing the message value (required)stringInformation: Array of string information objects (required)
value: String representing the string information value (required)footerInformation: Array of footer information objects (required)
share: Object containing share information (required)
cellphone: String representing the cellphone number (required)
message: String representing the message (required)
Important: This response will be returned within a timeout of 60,000 milliseconds (60 seconds).
\n","urlObject":{"protocol":"{{protocol}}","path":["sells","sell"],"host":["{{serverNameCommerceApi}}"],"query":[],"variable":[]}},"response":[{"id":"e3c09a94-1290-4963-af2a-662f50fce904","name":"success","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 202,\r\n \"amount\": 50,\r\n \"data\": {\r\n \"cellphone\": \"3015874029\",\r\n \"email\": \"correo@refacil.com\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"Operation successful.\",\r\n \"messageCode\": \"00\",\r\n \"data\": {\r\n \"date\": 0,\r\n \"sellId\": 0,\r\n \"payload\": {\r\n \"preBalance\": 0,\r\n \"posBalance\": 0,\r\n \"tmpBalance\": 0,\r\n \"debt\": 0,\r\n \"billData\": {\r\n \"fields\": [\r\n {\r\n \"name\": \"string\",\r\n \"type\": \"string\",\r\n \"options\": [\r\n {\r\n \"label\": \"string\",\r\n \"value\": \"string\"\r\n }\r\n ],\r\n \"label\": \"string\",\r\n \"placeholder\": \"string\",\r\n \"required\": true\r\n }\r\n ],\r\n \"costs\": [\r\n {\r\n \"label\": \"string\",\r\n \"value\": 0\r\n }\r\n ],\r\n \"messages\": [\r\n {\r\n \"value\": \"string\"\r\n }\r\n ],\r\n \"stringInformation\": [\r\n {\r\n \"value\": \"string\"\r\n }\r\n ],\r\n \"footerInformation\": [\r\n {}\r\n ],\r\n \"share\": {\r\n \"cellphone\": \"string\",\r\n \"message\": \"string\"\r\n }\r\n }\r\n }\r\n }\r\n}"}],"_postman_id":"eb4f1975-d190-4f0c-9924-12661db351ad"}],"id":"62cc475a-e56d-4fc9-b55f-29df1c3c4f67","_postman_id":"62cc475a-e56d-4fc9-b55f-29df1c3c4f67","description":""},{"name":"DirectTV","item":[{"name":"Product | DirectTV GO (1014005)","id":"6766fccb-385e-4c45-b3bf-6e8d0a5567f2","request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"cellphone\": \"3104784242\",\r\n \"email\": \"fake@refacil.com\"\r\n },\r\n \"productId\": 1014005\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell","description":"Allows performing a bill payment operation on the platform. Send the request body with the necessary parameters for the payment in the format specified by the PaymentBody object. The response will include the results of the operation in case of success.
\nproductId: Number representing the product identifier (required)
data: Object containing additional data (required)
cellphone: String containing the cellphone number (required)
email: String containing the email address (required)
message: String containing a message about the operation result (required)
messageCode: String code indicating the operation result (required)
data: Object containing additional response data (required)
date: Number representing the timestamp of the operation (required)
sellId: Number representing the identifier of the sell operation (required)
payload: Object containing the main response data (required)
preBalance: Number representing the balance before the operation (required)
posBalance: Number representing the balance after the operation (required)
tmpBalance: Number representing the temporary balance (required)
debt: Number representing the debt amount (required)
billData: Object containing bill-related data (required)
fields: Array of field objects (required)
name: String representing the field name (required)
type: String representing the field type (required)
options: Array of option objects (required)
label: String representing the option label (required)
value: String representing the option value (required)
label: String representing the field label (required)
placeholder: String representing the field placeholder (required)
required: Boolean indicating if the field is required (required)
costs: Array of cost objects (required)
label: String representing the cost label (required)
value: Number representing the cost value (required)
messages: Array of message objects (required)
value: String representing the message value (required)stringInformation: Array of string information objects (required)
value: String representing the string information value (required)footerInformation: Array of footer information objects (required)
share: Object containing share information (required)
cellphone: String representing the cellphone number (required)
message: String representing the message (required)
Allows performing a bill payment operation on the platform. Send the request body with the necessary parameters for the payment in the format specified by the PaymentBody object. The response will include the results of the operation in case of success.
\nproductId: Number representing the product identifier (required)
data: Object containing additional data (required)
cellphone: String containing the cellphone number (required)
email: String containing the email address (required)
message: String containing a message about the operation result (required)
messageCode: String code indicating the operation result (required)
data: Object containing additional response data (required)
date: Number representing the timestamp of the operation (required)
sellId: Number representing the identifier of the sell operation (required)
payload: Object containing the main response data (required)
preBalance: Number representing the balance before the operation (required)
posBalance: Number representing the balance after the operation (required)
tmpBalance: Number representing the temporary balance (required)
debt: Number representing the debt amount (required)
billData: Object containing bill-related data (required)
fields: Array of field objects (required)
name: String representing the field name (required)
type: String representing the field type (required)
options: Array of option objects (required)
label: String representing the option label (required)
value: String representing the option value (required)
label: String representing the field label (required)
placeholder: String representing the field placeholder (required)
required: Boolean indicating if the field is required (required)
costs: Array of cost objects (required)
label: String representing the cost label (required)
value: Number representing the cost value (required)
messages: Array of message objects (required)
value: String representing the message value (required)stringInformation: Array of string information objects (required)
value: String representing the string information value (required)footerInformation: Array of footer information objects (required)
share: Object containing share information (required)
cellphone: String representing the cellphone number (required)
message: String representing the message (required)
Allows performing a bill payment operation on the platform. Send the request body with the necessary parameters for the payment in the format specified by the PaymentBody object. The response will include the results of the operation in case of success.
\nproductId: Number representing the product identifier (required)
data: Object containing additional data (required)
cellphone: String containing the cellphone number (required)
email: String containing the email address (required)
message: String containing a message about the operation result (required)
messageCode: String code indicating the operation result (required)
data: Object containing additional response data (required)
date: Number representing the timestamp of the operation (required)
sellId: Number representing the identifier of the sell operation (required)
payload: Object containing the main response data (required)
preBalance: Number representing the balance before the operation (required)
posBalance: Number representing the balance after the operation (required)
tmpBalance: Number representing the temporary balance (required)
debt: Number representing the debt amount (required)
billData: Object containing bill-related data (required)
fields: Array of field objects (required)
name: String representing the field name (required)
type: String representing the field type (required)
options: Array of option objects (required)
label: String representing the option label (required)
value: String representing the option value (required)
label: String representing the field label (required)
placeholder: String representing the field placeholder (required)
required: Boolean indicating if the field is required (required)
costs: Array of cost objects (required)
label: String representing the cost label (required)
value: Number representing the cost value (required)
messages: Array of message objects (required)
value: String representing the message value (required)stringInformation: Array of string information objects (required)
value: String representing the string information value (required)footerInformation: Array of footer information objects (required)
share: Object containing share information (required)
cellphone: String representing the cellphone number (required)
message: String representing the message (required)
Here you will find all the endpoints related to the sale of pins.
\nNote: Sales related to pin products are returned in the 'extra' field, where the encrypted PIN in base64 format is included. This is the PIN that you must decrypt and send to the customer, as we cannot send it to your customers for internal policy reasons.
\n","_postman_id":"c22e8ff1-bb06-448a-82d9-5d2d9e882784"},{"name":"Energy","item":[{"name":"EPM","item":[{"name":"query","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"0e1f5ec0-25e4-46b2-8621-ca0baf00c018","request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"queryType\": \"ConfirmData\",\r\n \"productId\": 231,\r\n \"data\": {\r\n \"carrierId\": 231,\r\n \"cellphone\": \"3203550000\",\r\n \"amount\": 10000,\r\n \"reference\": \"1234567\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query","description":"Performs the pre-sale query for PIN flows, obtaining data such as reference, hash, and amount associated with the PIN purchase. The returned hashEchoData value must be forwarded in the subsequent sell request when completing the PIN transaction. If the response contains only one of the two hash fields, the API automatically mirrors it to the other.
If the request fails with the errorCode product.errors.disabled or a similar code indicating that the product is inactive, the agreements must be consulted again using the search service.
productId (number) required – Identifier of the product to query.
queryType (string) required – Type of query associated with the PIN flow.
Example: ConfirmData. Min length: 1.
data (object) required – Specific provider data for the PIN flow.
reference (string) required – Reference associated with the PIN transaction.
cellphone (string) required – Cellphone number associated with the PIN transaction.
amount (number) required – Amount of the PIN purchase.
carrierId (number) required – Identifier of the carrier/operator.
This field must have the same value as productId.
Important: This request will be processed within a timeout of 30,000 milliseconds (30 seconds).
\n","urlObject":{"protocol":"{{protocol}}","path":["product","query"],"host":["{{serverNameCommerceApi}}"],"query":[],"variable":[]}},"response":[{"id":"6bf54842-9387-4aec-9d76-be771bb03500","name":"Valid reference","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer MTcxMDQzNjY4MDkwNSQyYiQxMCRXOGtUZHlkOXVSM0FtM1puT2Vza3l1di92VnZtUTdaVGZGOWFnQUNta1NvRUxqY2c2ckJDaQ=="}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1000075,\r\n \"queryType\": \"BILLData\",\r\n \"ownAgreementId\": null,\r\n \"data\": {\r\n \"reference\": \"62540210\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 10 Jun 2024 18:14:33 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1020"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"3fc-08/BQd1GoTgQFWomzneceJEUUvU\""}],"cookie":[],"responseTime":null,"body":"{\n \"messageCode\": \"00\",\n \"message\": \"Operation successful.\",\n \"data\": {\n \"statusCode\": 200,\n \"message\": \"Successfully\",\n \"date\": 1773101286314,\n \"payload\": {\n \"amount\": 9999,\n \"productId\": 2010910,\n \"productName\": \"Facturas Otros SP\",\n \"reference\": \"63440172\",\n \"reference2\": null,\n \"hashEchoData\": \"eyJhZ3JlZW1lbnRJZCI6MzM3NDMsInJlZmVyZW5jZTEiOiI2MzQ0MDE3MiIsInJlZmVyZW5jZTIiOm51bGwsImFtb3VudCI6OTk5OSwiYWdyZWVtZW50TWVzc2FnZSI6IiIsImFncmVlbWVudENvZGUiOiIwMCIsInJlcXVpcmVzQW1vdW50IjoiMCIsImFkaXRpb25hbFZhbHVlNTRFY28iOiIwMTIzNDU2Nzg5MCIsImFkaXRpb25hbFZhbHVlNjJFY28iOiIxNTE2NTc4OTU1NjM0MjgxNjM4NzM5OTAyMjk1IiwiYWNjb3VudERhdGFBY3JlZGl0ZWQiOiI0NzU3NjY3MjA1ODE2Mzg3Mzk5MDIyOTUyMjc2IiwiYWRkaXRpb25hbENvbXBhbnlDb2RlIjoiMTUxNjU3ODk1NTYzNDI4MjgwNjI4MzcwMTIxMiIsImRhdGUiOiIyMDI2LTAzLTEwIiwidHJhY2UiOjUxMjF9\",\n \"amountEditable\": false,\n \"hash\": \"eyJhZ3JlZW1lbnRJZCI6MzM3NDMsInJlZmVyZW5jZTEiOiI2MzQ0MDE3MiIsInJlZmVyZW5jZTIiOm51bGwsImFtb3VudCI6OTk5OSwiYWdyZWVtZW50TWVzc2FnZSI6IiIsImFncmVlbWVudENvZGUiOiIwMCIsInJlcXVpcmVzQW1vdW50IjoiMCIsImFkaXRpb25hbFZhbHVlNTRFY28iOiIwMTIzNDU2Nzg5MCIsImFkaXRpb25hbFZhbHVlNjJFY28iOiIxNTE2NTc4OTU1NjM0MjgxNjM4NzM5OTAyMjk1IiwiYWNjb3VudERhdGFBY3JlZGl0ZWQiOiI0NzU3NjY3MjA1ODE2Mzg3Mzk5MDIyOTUyMjc2IiwiYWRkaXRpb25hbENvbXBhbnlDb2RlIjoiMTUxNjU3ODk1NTYzNDI4MjgwNjI4MzcwMTIxMiIsImRhdGUiOiIyMDI2LTAzLTEwIiwidHJhY2UiOjUxMjF9\"\n }\n }\n}"},{"id":"347ca2c0-6f1b-4f5f-8313-35ec456f1987","name":"Invalid reference","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer MTcxMDQzNjY4MDkwNSQyYiQxMCRXOGtUZHlkOXVSM0FtM1puT2Vza3l1di92VnZtUTdaVGZGOWFnQUNta1NvRUxqY2c2ckJDaQ=="}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1000075,\r\n \"queryType\": \"BILLData\",\r\n \"ownAgreementId\": null,\r\n \"data\": {\r\n \"reference\": \"63440172\" \r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 10 Jun 2024 18:20:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"142"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"8e-79rXl2moVmD3ZT3SgdvPXJ6Sb+U\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"Número de obligación o de factura inválido o no existe.\",\n \"timestamp\": 1718043635033\n}"},{"id":"ca9baac9-5234-413c-8756-e9ff766ee761","name":"Reference already paid","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer MTcxMDQzNjY4MDkwNSQyYiQxMCRXOGtUZHlkOXVSM0FtM1puT2Vza3l1di92VnZtUTdaVGZGOWFnQUNta1NvRUxqY2c2ckJDaQ=="}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1000075,\r\n \"queryType\": \"BILLData\",\r\n \"ownAgreementId\": null,\r\n \"data\": {\r\n \"reference\": \"62970322\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 10 Jun 2024 18:19:47 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"111"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"6f-3dDmq8rugT3rKm4gar26pe6UYMw\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"Este pago ya fue realizado.\",\n \"timestamp\": 1718043587188\n}"}],"_postman_id":"0e1f5ec0-25e4-46b2-8621-ca0baf00c018"},{"name":"sell","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"1d05a749-1072-402a-baf1-f248ecf836b5","request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 231,\r\n \"amount\": 10000,\r\n \"data\": {\r\n \"plan\": \"AP\",\r\n \"reference\": \"1234567\",\r\n \"cellphone\": \"3203550000\",\r\n \"hashEchoData\": \"eyJub21icmVfY2xpZW50ZSI6IkVMU1kgU0VyVklDRSIsImRpcmVjY2lvbiI6IlVSQiBWSUxMQSBWSUNUT1JJQSBDQVNBIDEwMyAtIFNBTiBNQVJUSU4iLCJkbmlfY2xpZW50ZSI6IjM5MDIyMDMxIiwiY29udHJhdG8iOiIxMjM0NTY3IiwidmFsb3JfdmVudGEiOiIxMDAwMCIsInBsYW4iOiIiLCJ0eXBlIjoiIn0=\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell","description":"Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
\nNote: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
\nThe timeout value specified below is directly established by the provider and must be taken into account in integrations.
\nproductId: Number representing the product identifier (required).amount: Number representing the amount of the payment. Minimum value: 10,000 (required).data: Object containing additional data (required):plan: String that identifies the type of plan for the payment (required).AP: Plan with public lighting (Alumbrado público).SP: Plan without public lighting (Sin alumbrado público).reference: String containing the reference number for the payment (required).cellphone: String containing the cellphone number associated with the payment (required).hashEchoData: String containing the hash echo data for the operation (required).message: String containing a message about the operation result (required)
messageCode: String code indicating the operation result (required)
data: Object containing additional response data (required)
date: Number representing the timestamp of the operation (required)
sellId: Number representing the identifier of the sell operation (required)
payload: Object containing the main response data (required)
preBalance: Number representing the balance before the operation (required)
posBalance: Number representing the balance after the operation (required)
tmpBalance: Number representing the temporary balance (required)
debt: Number representing the debt amount (required)
billData: Object containing bill-related data (required)
fields: Array of field objects (required)
name: String representing the field name (required)
type: String representing the field type (required)
options: Array of option objects (required)
label: String representing the option label (required)
value: String representing the option value (required)
label: String representing the field label (required)
placeholder: String representing the field placeholder (required)
required: Boolean indicating if the field is required (required)
costs: Array of cost objects (required)
label: String representing the cost label (required)
value: Number representing the cost value (required)
messages: Array of message objects (required)
value: String representing the message value (required)stringInformation: Array of string information objects (required)
value: String representing the string information value (required)footerInformation: Array of footer information objects (required)
share: Object containing share information (required)
cellphone: String representing the cellphone number (required)
message: String representing the message (required)
Performs the pre-sale query for PIN flows, obtaining data such as reference, hash, and amount associated with the PIN purchase. The returned hashEchoData value must be forwarded in the subsequent sell request when completing the PIN transaction. If the response contains only one of the two hash fields, the API automatically mirrors it to the other.
If the request fails with the errorCode product.errors.disabled or a similar code indicating that the product is inactive, the agreements must be consulted again using the search service.
productId (number) required – Identifier of the product to query.
queryType (string) required – Type of query associated with the PIN flow.
Example: ConfirmData. Min length: 1.
data (object) required – Specific provider data for the PIN flow.
reference (string) required – Reference associated with the PIN transaction.
cellphone (string) required – Cellphone number associated with the PIN transaction.
amount (number) required – Amount of the PIN purchase.
carrierId (number) required – Identifier of the carrier/operator.
This field must have the same value as productId.
plan (string) required – Identifies the type of plan associated with the transaction.
Allowed values:
AP: Plan with public lighting (Alumbrado público).
SP: Plan without public lighting (Sin alumbrado público).
type (string) required – Identifies the type of payment.
Allowed values:
PT: Total payment (Pago Total).
PM: Minimum payment (Pago Mínimo).
Important: This request will be processed within a timeout of 30,000 milliseconds (30 seconds).
\n","urlObject":{"protocol":"{{protocol}}","path":["product","query"],"host":["{{serverNameCommerceApi}}"],"query":[],"variable":[]}},"response":[{"id":"4871e716-a5e0-4a28-bea0-cbccb7b4595f","name":"Valid reference","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer MTcxMDQzNjY4MDkwNSQyYiQxMCRXOGtUZHlkOXVSM0FtM1puT2Vza3l1di92VnZtUTdaVGZGOWFnQUNta1NvRUxqY2c2ckJDaQ=="}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1000075,\r\n \"queryType\": \"BILLData\",\r\n \"ownAgreementId\": null,\r\n \"data\": {\r\n \"reference\": \"62540210\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 10 Jun 2024 18:14:33 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1020"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"3fc-08/BQd1GoTgQFWomzneceJEUUvU\""}],"cookie":[],"responseTime":null,"body":"{\n \"messageCode\": \"00\",\n \"message\": \"Operation successful.\",\n \"data\": {\n \"statusCode\": 200,\n \"message\": \"Successfully\",\n \"date\": 1773101286314,\n \"payload\": {\n \"amount\": 9999,\n \"productId\": 2010910,\n \"productName\": \"Facturas Otros SP\",\n \"reference\": \"63440172\",\n \"reference2\": null,\n \"hashEchoData\": \"eyJhZ3JlZW1lbnRJZCI6MzM3NDMsInJlZmVyZW5jZTEiOiI2MzQ0MDE3MiIsInJlZmVyZW5jZTIiOm51bGwsImFtb3VudCI6OTk5OSwiYWdyZWVtZW50TWVzc2FnZSI6IiIsImFncmVlbWVudENvZGUiOiIwMCIsInJlcXVpcmVzQW1vdW50IjoiMCIsImFkaXRpb25hbFZhbHVlNTRFY28iOiIwMTIzNDU2Nzg5MCIsImFkaXRpb25hbFZhbHVlNjJFY28iOiIxNTE2NTc4OTU1NjM0MjgxNjM4NzM5OTAyMjk1IiwiYWNjb3VudERhdGFBY3JlZGl0ZWQiOiI0NzU3NjY3MjA1ODE2Mzg3Mzk5MDIyOTUyMjc2IiwiYWRkaXRpb25hbENvbXBhbnlDb2RlIjoiMTUxNjU3ODk1NTYzNDI4MjgwNjI4MzcwMTIxMiIsImRhdGUiOiIyMDI2LTAzLTEwIiwidHJhY2UiOjUxMjF9\",\n \"amountEditable\": false,\n \"hash\": \"eyJhZ3JlZW1lbnRJZCI6MzM3NDMsInJlZmVyZW5jZTEiOiI2MzQ0MDE3MiIsInJlZmVyZW5jZTIiOm51bGwsImFtb3VudCI6OTk5OSwiYWdyZWVtZW50TWVzc2FnZSI6IiIsImFncmVlbWVudENvZGUiOiIwMCIsInJlcXVpcmVzQW1vdW50IjoiMCIsImFkaXRpb25hbFZhbHVlNTRFY28iOiIwMTIzNDU2Nzg5MCIsImFkaXRpb25hbFZhbHVlNjJFY28iOiIxNTE2NTc4OTU1NjM0MjgxNjM4NzM5OTAyMjk1IiwiYWNjb3VudERhdGFBY3JlZGl0ZWQiOiI0NzU3NjY3MjA1ODE2Mzg3Mzk5MDIyOTUyMjc2IiwiYWRkaXRpb25hbENvbXBhbnlDb2RlIjoiMTUxNjU3ODk1NTYzNDI4MjgwNjI4MzcwMTIxMiIsImRhdGUiOiIyMDI2LTAzLTEwIiwidHJhY2UiOjUxMjF9\"\n }\n }\n}"},{"id":"e0a84b22-ae75-4c1e-91d9-1a3e76027e7d","name":"Invalid reference","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer MTcxMDQzNjY4MDkwNSQyYiQxMCRXOGtUZHlkOXVSM0FtM1puT2Vza3l1di92VnZtUTdaVGZGOWFnQUNta1NvRUxqY2c2ckJDaQ=="}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1000075,\r\n \"queryType\": \"BILLData\",\r\n \"ownAgreementId\": null,\r\n \"data\": {\r\n \"reference\": \"63440172\" \r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 10 Jun 2024 18:20:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"142"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"8e-79rXl2moVmD3ZT3SgdvPXJ6Sb+U\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"Número de obligación o de factura inválido o no existe.\",\n \"timestamp\": 1718043635033\n}"},{"id":"9676669e-1d75-4897-8bc9-6752a165ac12","name":"Reference already paid","originalRequest":{"method":"POST","header":[{"key":"x-origin-commerce","value":"pay","disabled":true},{"key":"Authorization","value":"Bearer MTcxMDQzNjY4MDkwNSQyYiQxMCRXOGtUZHlkOXVSM0FtM1puT2Vza3l1di92VnZtUTdaVGZGOWFnQUNta1NvRUxqY2c2ckJDaQ=="}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 1000075,\r\n \"queryType\": \"BILLData\",\r\n \"ownAgreementId\": null,\r\n \"data\": {\r\n \"reference\": \"62970322\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/product/query"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 10 Jun 2024 18:19:47 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"111"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"6f-3dDmq8rugT3rKm4gar26pe6UYMw\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"Este pago ya fue realizado.\",\n \"timestamp\": 1718043587188\n}"}],"_postman_id":"e29858d7-7148-4cfd-ad14-fdd3ab95bd9e"},{"name":"sell","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"39fc49cb-fe0f-4300-9733-933997e1c0f2","request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"productId\": 230,\r\n \"amount\": 10000,\r\n \"data\": {\r\n \"cellphone\": \"3203550000\",\r\n \"plan\": \"AP\",\r\n \"reference\": \"1234567\",\r\n \"hashEchoData\": \"eyJub21icmVfY2xpZW50ZSI6IkVMU1kgU0VyVklDRSIsImRpcmVjY2lvbiI6IlVSQiBWSUxMQSBWSUNUT1JJQSBDQVNBIDEwMyAtIFNBTiBNQVJUSU4iLCJkbmlfY2xpZW50ZSI6IjM5MDIyMDMxIiwiY29udHJhdG8iOiIxMjM0NTY3IiwidmFsb3JfdmVudGEiOiIxMDAwMCIsInZhbG9yX2FzZW8iOjUwMDAsInZhbG9yX2VuZXJnaWEiOjUwMDAsImNlbHVsYXIiOiIzMjAzNTUwMDAwIiwiaWRDb25maXJtYWNpb24iOiJzZGpha3NkamRqYS1kYXMwZGRhbnNkMDItZnNhZGthc2RrNTYiLCJwbGFuIjoiQVAiLCJ0eXBlIjoiUFQifQ==\",\r\n \"type\": \"PT\",\r\n \"valorAseo\": 5000,\r\n \"valorEnergia\": 5000\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell","description":"Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
\nNote: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
\nThe timeout value specified below is directly established by the provider and must be taken into account in integrations.
\nproductId (number) required – Identifier of the product.
amount (number) required – Amount of the payment.
Minimum value: 10,000.
hash (string) required – Hash value for the operation.
data (object) required – Additional data for the payment.
reference (string) required – Reference number for the payment.cellphone (string) required – Cellphone number associated with the payment.hashEchoData (string) required – Hash echo data for the operation.plan (string) required – Identifies the type of plan associated with the transaction.AP: Plan with public lighting (Alumbrado público).SP: Plan without public lighting (Sin alumbrado público).type (string) required – Identifies the type of payment.PT: Total payment (Pago Total).PM: Minimum payment (Pago Mínimo).valorAseo (number) required – Cleaning/garbage charge amount associated with the transaction.query operation.valorEnergia (number) required – Energy charge amount associated with the transaction.query operation.message: String containing a message about the operation result (required)
messageCode: String code indicating the operation result (required)
data: Object containing additional response data (required)
date: Number representing the timestamp of the operation (required)
sellId: Number representing the identifier of the sell operation (required)
payload: Object containing the main response data (required)
preBalance: Number representing the balance before the operation (required)
posBalance: Number representing the balance after the operation (required)
tmpBalance: Number representing the temporary balance (required)
debt: Number representing the debt amount (required)
billData: Object containing bill-related data (required)
fields: Array of field objects (required)
name: String representing the field name (required)
type: String representing the field type (required)
options: Array of option objects (required)
label: String representing the option label (required)
value: String representing the option value (required)
label: String representing the field label (required)
placeholder: String representing the field placeholder (required)
required: Boolean indicating if the field is required (required)
costs: Array of cost objects (required)
label: String representing the cost label (required)
value: Number representing the cost value (required)
messages: Array of message objects (required)
value: String representing the message value (required)stringInformation: Array of string information objects (required)
value: String representing the string information value (required)footerInformation: Array of footer information objects (required)
share: Object containing share information (required)
cellphone: String representing the cellphone number (required)
message: String representing the message (required)
Step 1: POC requests transaction: The POC initiates a transaction request to the Integrator.
\nStep 2: Integrator forwards the request to Refacil API: The Integrator forwards the request to the Refacil API for further processing.
\nStep 3: Refacil API sends request to Transfiya: The Refacil API sends a request to Transfiya to create a transaction.
\nStep 4: Refacil creates pending transaction: The Refacil system creates a pending transaction and returns the response to the Integrator.
\nStep 5: Transfiya notifies banks by SMS: Transfiya sends SMS notification to the user and sends push notifications to all banks associated with the user, informing them about the pending transaction.
\nStep 6: User approves transaction: The end-user approves the transaction through bank application.
\nStep 7: Transfiya notifies Refacil API: Once the user approves the transaction, Transfiya sends a notification to the Refacil API indicating the status of the transaction.
\nStep 8: Refacil API notifies Integrator: The Refacil API notifies the Integrator of the transaction status, using a webhook mechanism. For each transaction state (in this case, PENDING), it sends data that includes the sale ID and transaction status.
\nStep 9: Transaction processing (If completed): If the transaction status changes to \"COMPLETED,\" the system processes the transaction by:
\nAdding balance to the user's account.
\nProcessing commissions related to the transaction.
\nStep 1: POC requests transaction: The POC initiates a transaction request to the Integrator.
\nStep 2: Integrator forwards the request to Refacil API: The Integrator forwards the request to the Refacil API for further processing.
\nStep 3: Refacil API sends request to Transfiya: The Refacil API sends a request to Transfiya to create a transaction.
\nStep 4: Refacil creates pending transaction: The Refacil system creates a pending transaction and returns the response to the Integrator.
\nStep 5: Transfiya notifies banks by SMS: Transfiya sends SMS notification to the user and sends push notifications to all banks associated with the user, informing them about the pending transaction.
\nStep 6: User rejects the transaction: The user rejects the transaction, causing the process to fail.
\nStep 7: Transfiya notifies Refacil API: Once the user rejects the transaction, Transfiya sends a notification back to the Refacil API, indicating that the transaction has been marked as failed.
\nStep 8: Refacil API notifies Integrator: The Refacil API notifies the Integrator using a webhook, providing details about the failed transaction.
\nStep 9: Transaction marked as failed: If the transaction status changes to \"REJECTED,\" the transaction is officially marked as failed within the system.
\nUse the following phone numbers to simulate successful or failed withdrawal transactions in the testing environment:
\n","urlObject":{"protocol":"{{protocol}}","path":["sells","sell"],"host":["{{serverNameCommerceApi}}"],"query":[],"variable":[]}},"response":[{"id":"88785e66-f51c-464e-822a-bfbc4aa2d313","name":"Success","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"productId\": 241,\n \"amount\": 20000,\n \"webhookUrl\": \"https://my-webhook.com\",\n \"data\": {\n \"cellphone\": \"3051000090\",\n \"bankName\": \"banco rojo\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 29 Aug 2024 14:58:21 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1187"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"4a3-aoVA3I7bVNm/Xfi0tNXDXphNWyg\""}],"cookie":[],"responseTime":null,"body":"{\n \"messageCode\": \"00\",\n \"message\": \"Operation successful.\",\n \"data\": {\n \"statusCode\": 200,\n \"message\": \"Solicitud de Retiro Exitosa\",\n \"date\": 1724943501941,\n \"payload\": {\n \"posBalance\": \"$7,888,014.00\",\n \"tmpBalance\": \"$6,500.00\",\n \"debt\": 0,\n \"billData\": {\n \"fields\": [\n {\n \"label\": \"Producto\",\n \"value\": \"Retiros\"\n },\n {\n \"label\": \"Fecha:\",\n \"value\": \"2024-08-29\"\n },\n {\n \"label\": \"Hora:\",\n \"value\": \"09:58:21\"\n },\n {\n \"label\": \"Código:\",\n \"value\": 441187188\n },\n {\n \"label\": \"Código del proveedor:\",\n \"value\": \"8QIH9bjQkHRP8dZKO\"\n },\n {\n \"label\": \"Código proveedor\",\n \"value\": \"8QIH9bjQkHRP8dZKO\",\n \"type\": null,\n \"labelLink\": null\n },\n {\n \"label\": \"Nro cliente\",\n \"value\": \"3051000090\",\n \"type\": null,\n \"labelLink\": null\n }\n ],\n \"costs\": [\n {\n \"label\": \"Valor venta\",\n \"value\": 20000,\n \"type\": null,\n \"labelLink\": null\n }\n ],\n \"messages\": [],\n \"share\": {\n \"cellphone\": \"3051000090\",\n \"message\": \"¡Hola!, has comprado (Retiros) por valor de $20000, este es el código de la venta 441187188. A continuación podrás encontrar un link con el comprobante. https://plataforma.refacil.co/#/factura/348024/441187188\"\n }\n },\n \"isPending\": true,\n \"sale\": {\n \"id\": 441187188,\n \"userId\": 348024,\n \"amount\": 20000,\n \"serviceNumber\": \"3051000090\",\n \"status\": 1,\n \"productId\": 241,\n \"createdAt\": \"2024-08-29T14:58:21.000Z\",\n \"transactionId\": \"8QIH9bjQkHRP8dZKO\",\n \"extra\": null\n }\n }\n }\n}"},{"id":"45485942-47de-484b-8138-48b313314434","name":"Amount out of range","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"productId\": 241,\n \"amount\": 2010,\n \"data\": {\n \"cellphone\": \"3051000002\",\n \"bankName\": \"BANCOLOMBIA\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Jun 2024 17:02:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"133"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"85-lNzgwY3kvbR2x+HFIWiLP/S+/+I\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"El monto ingresado está fuera del rango aceptado\",\n \"timestamp\": 1718125326534\n}"},{"id":"7302571c-476f-4e90-b45d-2461a9675849","name":"Cellphone required","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"productId\": 241,\n \"amount\": 20010,\n \"data\": {\n \"bankName\": \"BANCOLOMBIA\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Jun 2024 17:02:53 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"134"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"86-2HAOBwz459dUSzY7Zjj3niiU/MI\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"Identificador de la venta incorrecto\",\n \"timestamp\": 1718125373117,\n \"saleId\": null\n}"},{"id":"2cfe948a-1682-42de-8c5c-b0cd10187f5f","name":"Cellphone without proper format","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"productId\": 241,\n \"amount\": 20010,\n \"data\": {\n \"cellphone\": \"30510000023\",\n \"bankName\": \"BANCOLOMBIA\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Jun 2024 17:03:40 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"656"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"290-U908lqKXqtLhPGEkcYELKFo+oXI\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"cellphone must be shorter than or equal to 10 characters\",\n \"timestamp\": 1718125420378,\n \"saleId\": 431984508,\n \"result\": {\n \"status\": \"error\",\n \"_request\": {\n \"cellphone\": \"30510000023\",\n \"amount\": 20010,\n \"reference\": 431984508,\n \"infoReference\": \"withdrawals\",\n \"transactionId\": 302063,\n \"description\": \"withdrawals\",\n \"acceptSms\": \"¡Comercio PuebasQAVendo te solicito $20,010 por Transfiya!. Solo autoriza el retiro en tu app bancaria.\",\n \"bankName\": \"BANCOLOMBIA\"\n },\n \"_result\": {\n \"statusCode\": \"97\",\n \"message\": \"cellphone must be shorter than or equal to 10 characters\"\n },\n \"message\": \"cellphone must be shorter than or equal to 10 characters\"\n }\n}"},{"id":"07277be4-d7ac-423a-8ed8-6fd24d8dd7b2","name":"Out-of-range hours","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"productId\": 241,\n \"amount\": 20010,\n \"data\": {\n \"cellphone\": \"3051004402\",\n \"bankName\": \"BANCOLOMBIA\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Jun 2024 20:35:47 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"165"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"a5-opEpHIKQuSaUUWVVnQFyA20RKng\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"Recuerda que no puedes realizar transacciones antes/despues de la hora estipulada\",\n \"timestamp\": 1718138147132\n}"}],"_postman_id":"7aaa0444-c45d-4ad7-b98c-d1144ecdecd0"},{"name":"Sell | Transfiya - Deposits","id":"82ebb2bf-612f-48c8-9f19-5a8875956f0a","protocolProfileBehavior":{"disabledSystemHeaders":{}},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{tokenLoginRegister}}"}]},"isInherited":false},"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"productId\": 240,\n \"amount\": 10100,\n \"webhookUrl\": \"https://my-webhook.com\",\n \"data\": {\n \"cellphone\": \"3051000002\",\n \"bankName\": \"banco rojo\"\n }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell","description":"For deposits with the following numbers the following tests can be carried out.
\nAutomatically approved: 3051000002
\nAutomatically rejected: 3002491283
\nStep 1: POC initiates a request: The POC sends a request to the Integrator specifying a selected bank where the deposit should occur.
\nStep 2: Integrator sends request to Refacil API: The Integrator forwards the deposit request to the Refacil API for processing.
\nStep 3: Refacil API sends request to Transfiya: The Refacil API sends a request to Transfiya to create the transaction and process the deposit.
\nStep 4: Refacil API creates a successful transaction: The Refacil API creates a successful transaction and debits the corresponding balance from the system.
\nStep 5: Transfiya validates and processes the transaction: Transfiya validates the transaction and processes it successfully. It also makes sure that the transaction is ready for the deposit.
\nStep 6: Transfiya notifies and deposits to the selected bank: Transfiya sends a notification that the deposit is successful and proceeds to deposit the amount to the selected bank account.
\nStep 7: Refacil API receives a notification from Transfiya: Transfiya sends a notification back to the Refacil API indicating that the transaction has been successfully completed.
\nStep 8: Refacil API notifies Integrator: The Refacil API notifies the Integrator of the transaction status, using a webhook mechanism. For each transaction state (in this case, COMPLETED), it sends data that includes the sale ID and transaction status.
\nStep 9: Process commissions: If the transaction status changes to \"COMPLETED,\" The system processes commissions related to the transaction after the deposit is made.
\nStep 1: POC requests a deposit to a selected bank: The POC initiates a deposit request to the Integrator, specifying the selected bank.
\nStep 2: Integrator forwards the request to Refacil API: The Integrator sends the deposit request to the Refacil API for further processing.
\nStep 3: Refacil API sends a request to Transfiya: The Refacil API forwards the request to Transfiya to process the transaction.
\nStep 4: Refacil API creates a \"successful\" transaction and debits the balance: At this stage, the Refacil API debits the balance, assuming the transaction will be successful, and awaits confirmation from Transfiya.
\nStep 5: Transfiya validates the transaction and marks it as failed: Transfiya processes the transaction but finds an issue that causes the transaction to fail. It returns this failed status to the Refacil API.
\nStep 6: Refacil API notifies Integrator via webhook: The Refacil API sends a webhook notification to the Integrator, informing them that the transaction has failed. The errorCode provides the reason for the failure, while the reversed field indicates whether the balance has been refunded.
Step 7: Handling the reversal: If the reversed field is false, the system will need to manually create a ticket to refund the balance to the POC.
Step 8: Processing error and refund: If the error is marked as reversed (reversed: true), two actions will be taken:
Refund the balance: The debited amount is returned to the user's account.
\nNo commission processing: Since the transaction failed, no commissions are processed for this transaction.
\nUse the following phone numbers to simulate successful or failed deposit transactions in the testing environment:
\n","urlObject":{"protocol":"{{protocol}}","path":["sells","sell"],"host":["{{serverNameCommerceApi}}"],"query":[],"variable":[]}},"response":[{"id":"2071cdbc-0df5-4b34-9da3-9ca6710ecf4d","name":"Success","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"productId\": 240,\n \"amount\": 10100,\n \"webhookUrl\": \"https://my-webhook.com\",\n \"data\": {\n \"cellphone\": \"3051004403\",\n \"bankName\": \"BANCOLOMBIA\"\n }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 18 Jun 2024 13:15:56 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"872"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"368-MMcs29Mj1Y/SnNUTBbVIolFLwxA\""}],"cookie":[],"responseTime":null,"body":"{\n \"messageCode\": \"00\",\n \"message\": \"Operation successful.\",\n \"data\": {\n \"statusCode\": 200,\n \"message\": \"Transacción Exitosa\",\n \"date\": 1718716556368,\n \"payload\": {\n \"posBalance\": \"$55,633,688.00\",\n \"tmpBalance\": \"$0.00\",\n \"billData\": {\n \"fields\": [\n {\n \"label\": \"Producto\",\n \"value\": \"Depósitos\"\n },\n {\n \"label\": \"Fecha:\",\n \"value\": \"2024-06-18\"\n },\n {\n \"label\": \"Hora:\",\n \"value\": \"08:15:56\"\n },\n {\n \"label\": \"Código:\",\n \"value\": 431984675\n },\n {\n \"label\": \"Código del proveedor:\",\n \"value\": \"\"\n },\n {\n \"label\": \"Código proveedor\",\n \"value\": \"3A5Hq7VC1eFChY3ny\"\n },\n {\n \"label\": \"Nro cliente\",\n \"value\": \"3051004403\"\n }\n ],\n \"costs\": [\n {\n \"label\": \"Valor venta\",\n \"value\": 10100\n }\n ],\n \"messages\": [],\n \"share\": {\n \"cellphone\": \"3051004403\",\n \"message\": \"¡Hola!, has comprado (Depósitos) por valor de $10100, este es el código de la venta 431984675. A continuación podrás encontrar un link con el comprobante. https://plataforma.refacil.co/#/factura/302063/431984675\"\n }\n },\n \"isPending\": false\n }\n }\n}"},{"id":"e0697382-2e07-4fae-9127-247209084414","name":"Amount out of range","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"productId\": 240,\n \"amount\": 3100000,\n \"data\": {\n \"cellphone\": \"3051000001\",\n \"bankName\": \"BANCOLOMBIA\"\n }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Jun 2024 16:24:54 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"133"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"85-tnRsn1NCq2VSJhPOTWw6Opbz6kM\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"El monto ingresado está fuera del rango aceptado\",\n \"timestamp\": 1718123094042\n}"},{"id":"9af9cd60-4fe3-4e55-9070-6f26c5f9f595","name":"Cellphone required","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"productId\": 240,\n \"amount\": 30000,\n \"data\": {\n \"bankName\": \"BANCOLOMBIA\"\n }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Jun 2024 16:29:54 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"134"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"86-txxklQiiy8sTI85SpMh2lStsde0\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"Identificador de la venta incorrecto\",\n \"timestamp\": 1718123394851,\n \"saleId\": null\n}"},{"id":"2b03874d-3da7-452d-9c6e-e34b405e0716","name":"Cellphone without proper format","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"productId\": 240,\n \"amount\": 10100,\n \"data\": {\n \"cellphone\": \"30510000023\",\n \"bankName\": \"BANCOLOMBIA\"\n }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Jun 2024 16:55:38 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"649"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"289-Xcrg2h5fhrMZ8L1sBKspBPjosXg\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"cellphone must be shorter than or equal to 10 characters\",\n \"timestamp\": 1718124938002,\n \"saleId\": 431984507,\n \"result\": {\n \"status\": \"error\",\n \"_request\": {\n \"cellphone\": \"30510000023\",\n \"amount\": 10100,\n \"reference\": 431984507,\n \"infoReference\": \"deposits\",\n \"transactionId\": 302063,\n \"description\": \"deposits\",\n \"acceptSms\": \"¡Comercio PuebasQAVendo te envio $10,100 por Transfiya!. Solo autoriza el deposito en tu app bancaria.\",\n \"bankName\": \"BANCOLOMBIA\"\n },\n \"_result\": {\n \"statusCode\": \"97\",\n \"message\": \"cellphone must be shorter than or equal to 10 characters\"\n },\n \"message\": \"cellphone must be shorter than or equal to 10 characters\"\n }\n}"},{"id":"1c5b4dba-0cd5-4bdb-b073-ab4b06d08214","name":"Out-of-range hours","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"productId\": 240,\n \"amount\": 10100,\n \"data\": {\n \"cellphone\": \"3051004402\",\n \"bankName\": \"BANCOLOMBIA\"\n }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Jun 2024 20:37:15 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"165"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"a5-exjOE9b88kh7RA7Ybl3WXcbgAmE\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"Recuerda que no puedes realizar transacciones antes/despues de la hora estipulada\",\n \"timestamp\": 1718138235913\n}"},{"id":"0b4c7ee2-c589-471f-a685-a9eb9b713aae","name":"Cellphone not associated with transfiya","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"productId\": 240,\n \"amount\": 10100,\n \"data\": {\n \"cellphone\": \"3051004403\",\n \"bankName\": \"BANCOLOMBIA\"\n }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNameCommerceApi}}/sells/sell"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Jun 2024 20:42:46 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"614"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self';style-src 'self';img-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src-attr 'none';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Server","value":"Refacil.com"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"ETag","value":"W/\"266-vOHCqSSeJLUHP3bbXxdxNvBpHiM\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"Recurso no existe en el sistema del proveedor\",\n \"timestamp\": 1718138566477,\n \"saleId\": 431984522,\n \"result\": {\n \"status\": \"error\",\n \"_request\": {\n \"cellphone\": \"3051004403\",\n \"amount\": 10100,\n \"reference\": 431984522,\n \"infoReference\": \"deposits\",\n \"transactionId\": 302063,\n \"description\": \"deposits\",\n \"acceptSms\": \"¡Comercio PuebasQAVendo te envio $10,100 por Transfiya!. Solo autoriza el deposito en tu app bancaria.\",\n \"bankName\": \"BANCOLOMBIA\"\n },\n \"_result\": {\n \"statusCode\": 121,\n \"message\": \"Recurso no existe en el sistema del proveedor\"\n },\n \"message\": \"Recurso no existe en el sistema del proveedor\"\n }\n}"}],"_postman_id":"82ebb2bf-612f-48c8-9f19-5a8875956f0a"}],"id":"6aa0e1e0-7870-4423-9d6d-52b425b76af2","description":"Here you will find all the endpoints related to Transfiya correspondent selling.
\nNote: The products associated with Transfiya Correspondent Sales have an administrative cost for each sale made. For more information, please contact your sales agent.
\nTo sell productos assicieated with Transfiya in mandatory implemnt the webhook. Throught the webhook the status of the transaction is notified. The webhook is a local Refacil proxy that forward the notifications requests to the final webhook.
\nThe JWT is generated with a public and private key. Refacil will provide a public key to validate the JWT. Here is an example to validate the JWT:
\nimport { verify } from 'jsonwebtoken';\nasync validateJwt(token: string): Promise<any> {\n const publicKey = 'the public key provided by Refacil...';\n try {\n const decoded = verify(token, publicKey, {\n algorithms: ['RS256'],\n });\n return {\n valid: true,\n message: 'Token is valid.',\n data: decoded,\n }; \n } catch (error) {\n if (error.name === 'JsonWebTokenError') {\n throw new ForbiddenException('Invalid token.');\n } else {\n throw new UnauthorizedException('Token verification failed.');\n }\n }\n}\n\n{\n \"saleId\": 438927666,\n \"status\": 0,\n \"transfiyaStatus\": \"PENDING\",\n \"reversed\": true,\n \"errorCode\": \"130\"\n}\n\ncurl --location --globoff 'https://acme.refacil.local/transfiYaNotifications' \\\n--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"saleId\": 438927666,\n \"status\": 0,\n \"transfiyaStatus\": \"REJECTED\",\n \"reversed\": true,\n \"errorCode\": \"TFYA302\"\n }'\n\nExecutes a sale or collection for any supported product.
\nFor invoice products (Bills), the hash and hashEchoData values returned by the preceding /products/query call must be included. For special products (Insurance, Packages, Recharges, etc.), refer to the specific request documentation within each subcategory.
productId (number) required - Product to sell.data (object) required - Contextual sale data. The fields inside this object vary by product — refer to each product's specific request for the expected structure.reference (string) - Invoice or payment reference. Used for bill products.cellphone (string) - Destination phone number. Used for top-ups and some bill products.phone (string) - Alternative destination phone field. Used by some top-up providers.plate (string) - Vehicle plate. Used for SOAT products.amount (number) - Requested amount. Used for products without a fixed amount.amount (number) - Sale amount. Omit when the product has a fixed amount.sellType (string) - Sale classification (\"Bill\", \"Topup\", etc.). Min length: 1 when sent.hash (string) - Hash returned by the preceding query. Required for bill products. Min length: 1 when sent.moveTmpBalance (boolean) - If true, instructs Movement to transfer temporary balance upon sale completion.webhookUrl (string) - URL for post-sale notifications. Min length: 1 when sent.terminalId (number) - Unique identifier of the PDV terminal processing the transaction. Enables special products for the selling user.commerceId (number) - Commerce identifier. Used to attribute transactions to the correct business location when an integrator consolidates multiple commerces._password (string) - Second key required by certain products.expiresIn (number) - Expiration time in seconds for webhook-based sales.messageCode (string) - Response status code.message (string) - Response message.data (object)date (number) - Sale timestamp.sellId (number) - Sale identifier in Movement.payload (object)preBalance (number) - Balance before the operation.posBalance (number) - Balance after the operation.tmpBalance (number) - Remaining temporary balance.debt (number) - Outstanding debt, if applicable.billData (object)fields (array) - Receipt field objects.label (string) - Field label.value (any) - Value associated with the label.costs (array) - Cost detail objects.messages (array) - Additional message objects.stringInformation (array) - Complementary legend strings.footerInformation (array) - Footer information for the receipt.share (object)cellphone (string) - Phone number to share the transaction.message (string) - Suggested text to share.This method allows you to obtain the details of a sale by providing the unique identifier of the sale.
\nsaleId: nique identifier of the sale. It can be found in the sell response as 'saleId', 'sellId', or 'codigo'.id: Unique identifier of the sale. 'sellId', or 'codigo'.
amount: The amount of the sale.
serviceNumber: The number or reference associated to the sale, it depends on the product. .e.g.For SOAT insurance it will be the plate. For packages it will be the phone number.
status: The status of the sale.
productId: The product id associated to the sale.
createdAt: The created at date.
transactionId: For TransfiYa product, it is the provider transaction id.
extra: Extra data of the sale, It depends on the product. e.g. For SOAT insurance it will be the PDF url of the insurance policy. For pins it will be the pin.
Here you will find all the endpoints related to multi-product sales.
\nNote: If you need information about parameterized commissions, you should consult your sales agent.
\nThe following error codes apply to all sell operations regardless of product type.
\nThis endpoint is in charge of reporting the collections
\nid_cliente (number, required): Unique identifier for the user
\nid_transaccion (number, required): Identifier for the transaction
\nconvenio (number, required): Code representing the specific agreement associated with the transaction
\nValor (number, required): Amount of the transaction
\nFecha (string, required): Date of the transaction
\nHora (string, required): Time of the transaction
\ncode: Respond correctly in case of successInquiries and sales are managed from a single generic merchant. The merchant has an Administration Portal to view reports and make balance purchases through the channels enabled by Super Pagos.
\nTo make sales, the merchant must have available balance in the Super Pagos portal.
\n\n\nYou will be able to target the consumption of our services through our following Endpoint :
\n
QA: https://commerce-api.qa.refacil.co/
Production: https://commerce-api.refacil.co/
\n\nNote: It should be noted that for each environment only the beginning of the Url is modified, the subsequent address is the same for both environments in the services that you will consume.
\n
\n\n","_postman_id":"a22235bc-bce5-46fa-add7-242af868dae2"},{"name":"Pay API 2.0","item":[{"name":"Authorization","item":[{"name":"Login","event":[{"listen":"test","script":{"exec":["const json = JSON.parse(responseBody)\r","pm.environment.set('tokenLogin', json.data.token)"],"type":"text/javascript","packages":{}}}],"id":"4114f081-fa91-49ea-81f7-06b648a6e8f8","protocolProfileBehavior":{"disabledSystemHeaders":{"content-type":true}},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"username\": \"{{username}}\",\n \"password\": \"{{secretKey}}\"\n}\n"},"url":"{{protocol}}://{{serverNamePayApi}}/auth/login","description":"","urlObject":{"protocol":"{{protocol}}","path":["auth","login"],"host":["{{serverNamePayApi}}"],"query":[],"variable":[]}},"response":[{"id":"6750aadd-579a-4ef4-b535-1201d5a57c61","name":"200: Ok Successful","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"username\": \"{{username}}\",\n \"password\": \"{{secretKey}}\"\n}\n"},"url":"{{protocol}}://{{serverNamePayApi}}/auth/login"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"192"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 16:08:11 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"c0-vMI66azG94sKX8pghwtFoV95Xxs\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains; preload"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Cache-Control","value":"no-cache"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 7fca1c00381ef50504deb286fd5fc26c.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"ORD53-C2"},{"key":"X-Amz-Cf-Id","value":"jufuYVrGnra1x7SwxZnq4K_QGKIA9sXt2AKP4SbCDXFOc-CCgkuHRg=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": \"00\",\n \"message\": \"Operación exitosa.\",\n \"data\": {\n \"tokenType\": \"Bearer\",\n \"token\": \"MTczMDQ3NzI5MTI0MiQyYiQxMCRqVFJhTmJMU2xCeURGNEh6R2NnWkl1MnF2cGlLQndZMzFPa1RCV21DYW9tRERrcWNFRFl2Z***\"\n }\n}"},{"id":"b0477a5c-db16-4914-95ed-f4ebcd4ce01b","name":"401: Invalid Credentials","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"username\": \"{{username}}\",\n \"password\": \"{{secretKey}}\"\n}\n"},"url":"{{protocol}}://{{serverNamePayApi}}/auth/login"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"123"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 15:53:13 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"7b-xbCVQnRozx58FA7fWZAOpg/hNqo\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 deea5d6ab704f91d89c52977d572f58e.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"eZxTFjJrYqLC4xMXu9zMgGl9QBf3zcDVPcAVSLAgpiZ6UqYQV6WwLQ=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Credenciales inválidas\",\n \"path\": \"/auth/login\",\n \"date\": 1730476393394\n}"}],"_postman_id":"4114f081-fa91-49ea-81f7-06b648a6e8f8"}],"id":"160c2d6b-a47d-4bc6-9634-51ebbe0a85ea","description":"API implementation credentials in test environment will be available throughout the integration and up to 30 days after certification in production.
\n
To make the request and obtain the login you must have very clear your username and password for each environment where you are going to perform the integration, this information should be requested to our support team (soportetecnico@refacil.com).
\nWithin the post you will see below are the fields to make your request
\n\n\n","_postman_id":"160c2d6b-a47d-4bc6-9634-51ebbe0a85ea"},{"name":"Transactional token","item":[{"name":"Transactional token link","event":[{"listen":"test","script":{"exec":["const json = JSON.parse(responseBody)\r","pm.environment.set('transactionalToken', json.data.token);"],"type":"text/javascript","packages":{}}}],"id":"22be304e-76ab-47a7-bac2-055cb3c5fcd9","request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/cash-in/generate/payment-link/token\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNamePayApi}}/trx-token/generate","description":"","urlObject":{"protocol":"{{protocol}}","path":["trx-token","generate"],"host":["{{serverNamePayApi}}"],"query":[],"variable":[]}},"response":[{"id":"3e34aa8d-93d6-4e08-9ea9-9f5d8eaf81c2","name":"200: Ok Successful","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/cash-in/generate/payment-link/token\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"107"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:17:25 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"6b-0dCGoZWHzsNFKqnQWZCYbct/JaY\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains; preload"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Cache-Control","value":"no-cache"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"CXZ2m9SOeqNyF_xQbqGXkHDA8Ora3unN419YKniR4GCxN5CsgRANEA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": \"00\",\n \"message\": \"Operación exitosa.\",\n \"data\": {\n \"token\": \"4f2f1a68-988e-11ef-95a6-55d0f4788***\"\n }\n}"},{"id":"2162d5ea-27a7-461d-9178-ab6603c627bb","name":"401: Authentication error","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/cash-in/generate/payment-link/token\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"134"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:03 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"86-kcBuGThx4cPlprzs2xpVmJyz7fI\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"vQVNdZnlAF2O2YPtMv10xMZ2OJNvefoOIsh3FXaEXJqsT56hiy-GNA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Error en la autenticación\",\n \"date\": 1730492283161\n}"},{"id":"2f06db2c-dfd7-4a2c-a4f7-7d558d3a460a","name":"401: Authentication not found","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/cash-in/generate/payment-link/token\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"136"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:57 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"88-bwrowifrUlJgfsEZM/enGjUQtLc\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"MSC3fgs7xlHyD1mZJrcWZW3nojCkBGwO7vI3F6ZTJa1YcCUO58DeYw=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Autenticación no encontrada\",\n \"date\": 1730492337196\n}"}],"_postman_id":"22be304e-76ab-47a7-bac2-055cb3c5fcd9"},{"name":"Transactional token method","event":[{"listen":"test","script":{"exec":["const json = JSON.parse(responseBody)\r","pm.environment.set('transactionalToken', json.data.token);"],"type":"text/javascript","packages":{}}}],"id":"33b1a194-480a-4f90-a765-7a19b4ffc005","request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/cash-in/payment-method/token\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNamePayApi}}/trx-token/generate","description":"","urlObject":{"protocol":"{{protocol}}","path":["trx-token","generate"],"host":["{{serverNamePayApi}}"],"query":[],"variable":[]}},"response":[{"id":"2454b611-d41a-4e65-9f43-7f3ffa25cfef","name":"200: Ok Successful","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/cash-in/generate/payment-link/token\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"107"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:17:25 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"6b-0dCGoZWHzsNFKqnQWZCYbct/JaY\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains; preload"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Cache-Control","value":"no-cache"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"CXZ2m9SOeqNyF_xQbqGXkHDA8Ora3unN419YKniR4GCxN5CsgRANEA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": \"00\",\n \"message\": \"Operación exitosa.\",\n \"data\": {\n \"token\": \"4f2f1a68-988e-11ef-95a6-55d0f4788***\"\n }\n}"},{"id":"508f8a28-d563-4e62-acb1-05e915c1448d","name":"401: Authentication error","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/cash-in/generate/payment-link/token\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"134"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:03 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"86-kcBuGThx4cPlprzs2xpVmJyz7fI\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"vQVNdZnlAF2O2YPtMv10xMZ2OJNvefoOIsh3FXaEXJqsT56hiy-GNA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Error en la autenticación\",\n \"date\": 1730492283161\n}"},{"id":"c1109f7f-5699-425f-bbf4-8abf0bb79a40","name":"401: Authentication not found","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/cash-in/generate/payment-link/token\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"136"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:57 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"88-bwrowifrUlJgfsEZM/enGjUQtLc\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"MSC3fgs7xlHyD1mZJrcWZW3nojCkBGwO7vI3F6ZTJa1YcCUO58DeYw=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Autenticación no encontrada\",\n \"date\": 1730492337196\n}"}],"_postman_id":"33b1a194-480a-4f90-a765-7a19b4ffc005"},{"name":"Transactional token withdraw","event":[{"listen":"test","script":{"exec":["const json = JSON.parse(responseBody)\r","pm.environment.set('transactionalToken', json.data.token);"],"type":"text/javascript","packages":{}}}],"id":"40ebd945-7ea3-4d6f-9659-f3cf48fa217f","request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/cash-out/generate/withdraw-method/token\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNamePayApi}}/trx-token/generate","description":"","urlObject":{"protocol":"{{protocol}}","path":["trx-token","generate"],"host":["{{serverNamePayApi}}"],"query":[],"variable":[]}},"response":[{"id":"8c812909-a3bf-4782-88d2-83effc3e6311","name":"200: Ok Successful","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/cash-in/generate/payment-link/token\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"107"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:17:25 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"6b-0dCGoZWHzsNFKqnQWZCYbct/JaY\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains; preload"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Cache-Control","value":"no-cache"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"CXZ2m9SOeqNyF_xQbqGXkHDA8Ora3unN419YKniR4GCxN5CsgRANEA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": \"00\",\n \"message\": \"Operación exitosa.\",\n \"data\": {\n \"token\": \"4f2f1a68-988e-11ef-95a6-55d0f4788***\"\n }\n}"},{"id":"a18684f0-267d-4275-95ae-4262d1137821","name":"401: Authentication error","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/cash-in/generate/payment-link/token\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"134"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:03 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"86-kcBuGThx4cPlprzs2xpVmJyz7fI\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"vQVNdZnlAF2O2YPtMv10xMZ2OJNvefoOIsh3FXaEXJqsT56hiy-GNA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Error en la autenticación\",\n \"date\": 1730492283161\n}"},{"id":"d2acf766-11c4-4b06-9ca4-b30143d2f9fe","name":"401: Authentication not found","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/cash-in/generate/payment-link/token\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"136"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:57 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"88-bwrowifrUlJgfsEZM/enGjUQtLc\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"MSC3fgs7xlHyD1mZJrcWZW3nojCkBGwO7vI3F6ZTJa1YcCUO58DeYw=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Autenticación no encontrada\",\n \"date\": 1730492337196\n}"}],"_postman_id":"40ebd945-7ea3-4d6f-9659-f3cf48fa217f"},{"name":"Transactional token merchan key create","event":[{"listen":"test","script":{"exec":["const json = JSON.parse(responseBody)\r","pm.environment.set('transactionalToken', json.data.token);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"8b18185b-ebf5-44b1-8639-a4f8116597aa","request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/merchant-key/create\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNamePayApi}}/trx-token/generate","description":"","urlObject":{"protocol":"{{protocol}}","path":["trx-token","generate"],"host":["{{serverNamePayApi}}"],"query":[],"variable":[]}},"response":[{"id":"9488c77e-6e28-4365-bd33-0802ec7661c5","name":"200: Ok Successful","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/merchant-key/create\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"107"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:17:25 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"6b-0dCGoZWHzsNFKqnQWZCYbct/JaY\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains; preload"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Cache-Control","value":"no-cache"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"CXZ2m9SOeqNyF_xQbqGXkHDA8Ora3unN419YKniR4GCxN5CsgRANEA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": \"00\",\n \"message\": \"Operación exitosa.\",\n \"data\": {\n \"token\": \"4f2f1a68-988e-11ef-95a6-55d0f4788***\"\n }\n}"},{"id":"938c1605-838d-4d0c-8ada-d909af36ae28","name":"401: Authentication error","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/merchant-key/create\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"134"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:03 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"86-kcBuGThx4cPlprzs2xpVmJyz7fI\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"vQVNdZnlAF2O2YPtMv10xMZ2OJNvefoOIsh3FXaEXJqsT56hiy-GNA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Error en la autenticación\",\n \"date\": 1730492283161\n}"},{"id":"4f13b44d-225c-4b54-965b-f4f3559e6bc6","name":"401: Authentication not found","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/merchant-key/create\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"136"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:57 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"88-bwrowifrUlJgfsEZM/enGjUQtLc\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"MSC3fgs7xlHyD1mZJrcWZW3nojCkBGwO7vI3F6ZTJa1YcCUO58DeYw=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Autenticación no encontrada\",\n \"date\": 1730492337196\n}"}],"_postman_id":"8b18185b-ebf5-44b1-8639-a4f8116597aa"},{"name":"Transactional token merchant key cancel","event":[{"listen":"test","script":{"exec":["const json = JSON.parse(responseBody)\r","pm.environment.set('transactionalToken', json.data.token);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"d604a96e-f376-40d6-bcd0-0166e54037af","request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/merchant-key/cancel\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNamePayApi}}/trx-token/generate","description":"","urlObject":{"protocol":"{{protocol}}","path":["trx-token","generate"],"host":["{{serverNamePayApi}}"],"query":[],"variable":[]}},"response":[{"id":"63acfe9d-2122-41c5-a283-653deaa262b4","name":"200: Ok Successful","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/merchant-key/cancel\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"107"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:17:25 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"6b-0dCGoZWHzsNFKqnQWZCYbct/JaY\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains; preload"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Cache-Control","value":"no-cache"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"CXZ2m9SOeqNyF_xQbqGXkHDA8Ora3unN419YKniR4GCxN5CsgRANEA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": \"00\",\n \"message\": \"Operación exitosa.\",\n \"data\": {\n \"token\": \"4f2f1a68-988e-11ef-95a6-55d0f4788***\"\n }\n}"},{"id":"f1ceb9ac-450c-45b0-af4e-7205c7120e25","name":"401: Authentication error","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/merchant-key/cancel\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"134"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:03 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"86-kcBuGThx4cPlprzs2xpVmJyz7fI\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"vQVNdZnlAF2O2YPtMv10xMZ2OJNvefoOIsh3FXaEXJqsT56hiy-GNA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Error en la autenticación\",\n \"date\": 1730492283161\n}"},{"id":"bfb2bf99-ec69-4ec5-9505-740472ec092f","name":"401: Authentication not found","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service\": \"/merchant-key/cancel\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"136"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:57 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"88-bwrowifrUlJgfsEZM/enGjUQtLc\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"MSC3fgs7xlHyD1mZJrcWZW3nojCkBGwO7vI3F6ZTJa1YcCUO58DeYw=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Autenticación no encontrada\",\n \"date\": 1730492337196\n}"}],"_postman_id":"d604a96e-f376-40d6-bcd0-0166e54037af"}],"id":"8b438521-c85b-4302-89fc-e4c4a2206781","description":"Note that for the consumption of any of the API services it is necessary to send the authentication token that you get when consuming the auth/login service as an Authorization indicating the Type and Token.\nThe authentication token has an expiration time of 2 hours. Only consume this service after this time has elapsed or when the services that use the token return a 401 Unauthorized response.
\n
This service allows security validation for the execution of a transaction on the platform, generating a single-use token.
\n\n\nThe transactional token service is obtained in three ways, depending on the action to be performed. For this, the value sent in the service parameter must be set according to what is required:
\n
1. For Payment Link: “/cash-in/generate/payment-link/token”.
2. For Payment method: “/cash-in/generate/payment-method/token”.
3. For Withdraw: “/cash-out/generate/withdraw-method/token”.
4. For Merchant Key: [ “/merchant-key/create”, “/merchant-key/cancel” ]
\n\n","_postman_id":"8b438521-c85b-4302-89fc-e4c4a2206781"},{"name":"Payments","item":[{"name":"Payment Link","item":[{"name":"Generate payment link","id":"4e813188-5b4b-42cc-9423-24deadb641d8","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-transaction-token","value":"{{transactionalToken}}"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\n \"expiresIn\": 12360,\n \"amount\": 2000,\n \"brandId\": 117,\n \"webhookUrl\": \"https://webhook.site/8965aa0a-e3e7-4092-aa7d-6c44bf63f7a8\",\n \"userMetadata\": {\n \"ip\": \"1.2.3.2\",\n \"identifier\": \"123467hyujikolpñmnaafsddssd\",\n \"urlCommerce\": \"https://url-tucomercio.com\"\n },\n \"returnUrl\": \"https://www.google.com\",\n \"reference1\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"reference2\": {\n \"Label\": {\n \"Name\": \"Juanita Perez\",\n \"Email\": \"pqacLO87V77DgF62P8PXENA==do\",\n \"CellPhone\": \"1VM6daPPJcXCD4Cw93272oQ==8\",\n \"Type Person\": \"NATURAL\",\n \"Type Document\": \"CEDULA\",\n \"DocumentNumber\": 79706920,\n \"Nodo\": 47474\n },\n \"Data\": {\n \"Typedoc\": \"cedula\",\n \"docnum\": \"1088307172\"\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNamePayApi}}/cash-in/generate/payment-link/token","description":"The generated token is single-use for each transaction and cannot be consumed more than once. In addition, the transactional token will be valid for 60 seconds.
\n
With the following request you can obtain a payment resource with a link that will redirect your customer to the payment gateway where he will see a list of the different payment methods available.
\n","_postman_id":"3f520438-2d23-4366-bb10-06cbb1cca966"},{"name":"Payment Method","item":[{"name":"Generate payment method","id":"d024ef84-afb9-4a51-b495-47cb09f1bc32","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-transaction-token","value":"{{transactionalToken}}"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\n \"expiresIn\": 2592000,\n \"paymentMethod\": {\n \"id\": 277,\n \"cellphone\": \"3017765147\",\n \"pdfUrl\": \"https://testing-pay.s3.us-east-2.amazonaws.com/pdf/cashfactory/500.pdf\" // Optional\n },\n \"userMetadata\": {\n \"ip\": \"1.2.3.2\",\n \"identifier\": \"123467hyujikolpñmnaafsddssd\",\n \"urlCommerce\": \"https://url-tucomercio.com\"\n },\n \"amount\": 10000,\n \"brandId\": 1,\n \"webhookUrl\": \"https://webhook.site/271888cd-bd07-469a-88a8-e0ed7e93c368\",\n \"returnUrl\": \"https://www.google.com/?hl=es\",\n \"showSummary\": true,\n \"reference1\": \"EGfbOsiYQspMpgDD\",\n \"reference2\": {\n \"Label\": {\n \"Campos\": \"string\"\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/cash-in/generate/payment-method/token","description":"This endpoint allows you to generate payment requests through the available cash-in methods.
\nThe table below lists the available payment methods along with their corresponding IDs and minimum expiration times (expiresIn) required when creating a payment request.
\n\n⚠ Important:
\n
The value provided in the expiresIn field must be greater than or equal to the minimum expiration defined for the selected payment method.
For QR Interoperable (ID 248), theexpiresInparameter must be omitted. If provided, the system will ignore it automatically. The resource expiration is managed internally by the provider and is set to the end of the same day the resource is generated.
For Llaves Dinámicas Bre-B (ID 250), theexpiresInparameter must be omitted. If provided, the system will ignore it automatically. The key has a fixed validity period of 10 minutes from the moment of creation, determined by the server configuration.
Each payment method requires a specific object structure within the \"paymentMethod\" field.
\"paymentMethod\": {\n \"id\": 130,\n \"cellphone\": \"3105293225\"\n}\n\n\"paymentMethod\": {\n \"id\": 131,\n \"cellphone\": \"3208385715\"\n}\n\nFor this payment method, depending on the typePerson selected, only specific document types are accepted:
typePerson****: \"0\" → corresponds to a Natural Person and only accepts the following values for documentType:
RCN
TI
CC
TE
CE
PA
DIE
typePerson****: \"1\" → corresponds to a Legal Person and only accepts the following value for documentType:
NIT\"paymentMethod\": {\n \"id\": 133,\n \"documentType\": \"CC\",\n \"typePerson\": \"0\",\n \"bankId\": \"string\",\n \"documentNumber\": \"string\",\n \"name\": \"string\",\n \"cellphone\": \"string\",\n \"address\": \"string\",\n \"email\": \"string\"\n}\n\nThis payment method enables direct integration with the PSE network for processing online bank payments.
To consume this product, it is required to have the following parameters previously configured and associated with your product:
entity_code
service_code
company_ciiu
company_name
These parameters identify your company within the PSE network and are necessary for successful transaction routing and validation.
\n\n\n💬 For more information or to request these credentials, please contact the support team.
\n
This method follows the same structure and validation rules as PSE, but must use the following identifier:
\n\"paymentMethod\": {\n \"id\": 262,\n \"documentType\": \"CC\",\n \"typePerson\": \"0\",\n \"bankId\": \"string\",\n \"documentNumber\": \"string\",\n \"name\": \"string\",\n \"cellphone\": \"string\",\n \"address\": \"string\",\n \"email\": \"string\"\n}\n\nThe PSE integration relies heavily on the correct configuration of the showSummary and returnUrl parameters.
These parameters control the user experience and the finalization flow of the payment process.
\n\n⚠️ Note:
\n
For PSE and PSE Gateway, it is strongly recommended to useshowSummary: truealong with a validreturnUrlto ensure a seamless customer experience and accurate transaction tracking.
\n\n🔗 See also:
\n
\"paymentMethod\": {\n \"id\": 153\n}\n\nThis payment method supports an optional parameter called isQr, which determines the type of resource returned in the url field:
\n\n🧠 Behavior:
\n
IfisQris not provided, the default behavior is equivalent toisQr: false.
Transactions can only be completed from a mobile device.
If the request is made from a desktop or tablet, it is recommended to sendisQr: trueso the user can scan the QR from a mobile device.
\"paymentMethod\": {\n \"id\": 163,\n \"isQr\": false\n}\n\nFor this method, the following fields are optional:
\ncellphone
documentNumber
documentType
merchantId
The service can function using only the payment method ID; however, providing these optional fields can improve response time.
You may retrieve this data through the enrollment-data service in the Merchant Enrollment section.
\n\n⚠ Prerequisite:
\n
The merchant must complete the Merchant Enrollment process before using this method.
See the Merchant Enrollment section for setup details.
\n\n🔁 Open Resource:
\n
The QR Interoperable operates as an open resource, meaning the generated QR can be used multiple times by the same user.
\n\n⚙️ Technical Note — Dynamic QR Behavior:
\n
Dynamic QR codes may be scanned multiple times due to current limitations in the Redeban system.
This is not an error in our platform.
\n\n🕐 Expiration Behavior:
\n
TheexpiresInparameter does not apply to this payment method and should be omitted from the request.
If a value is sent, the system will ignore it automatically.
The QR resource expiration is controlled exclusively by the provider (Redeban) and is always set to the end of the day on which the resource is generated (23:59:59 America/Bogota).
Redeban does not automatically invalidate a dynamic QR after its first scan.
\nAs a result, the same QR may generate multiple transaction records.
\nImplement application-level validation to detect multiple payments from the same QR code.
\nMonitor dynamic QR transactions and confirm status before marking payments as completed.
\nInform end-users to verify the success of a transaction before rescanning.
\nRedeban is evaluating support for single-use dynamic QR control.
\nStay updated with interoperability provider announcements to adjust integrations accordingly.
\n\"paymentMethod\": {\n \"id\": 248,\n \"cellphone\": \"string\",\n \"documentType\": \"string\",\n \"documentNumber\": \"string\",\n \"merchantId\": \"string\"\n}\n\nFor this method, the following fields are required:
\ncellphone
docNumber
docType
merchantId
You may retrieve this data through the enrollment-data service in the Merchant Enrollment section.
\n\n⚠ Prerequisite:
\n
The merchant must complete the Merchant Enrollment process before using this method.
See the Merchant Enrollment section for setup details.
\n\n🔁 Open Resource:
\n
The Llaves Dinamicas Bre-B operates as an open resource, meaning the generated KEY can be used multiple times by the same user.
\n\n⚙️ Technical Note — Dynamic Key Behavior:
\n
Dynamic keys may receive multiple money transfers due to current limitations in the Redeban system.
This behavior does not represent an error or malfunction in our platform.
Additionally, dynamic keys have a fixed validity period of 10 minutes, and this duration cannot be modified.
Redeban does not automatically invalidate a dynamic KEY after its first send.
\nAs a result, the same KEY may generate multiple transaction records.
\nImplement application-level validation to detect multiple payments from the same KEY.
\nMonitor dynamic KEY transactions and confirm status before marking payments as completed.
\nInform end-users to verify the success of a transaction before rescanning.
\n\"paymentMethod\": {\n \"id\": 250,\n \"cellphone\": \"string\",\n \"docType\": \"string\",\n \"docNumber\": \"string\",\n \"merchantId\": \"string\"\n}\n\nThis payment method allows processing payments with debit and credit cards (Mastercard and Visa).
\nFor this method, the following fields are required:
\nid: 273
description: Description of the payment detail that will be displayed in the payment link
\"paymentMethod\": {\n \"id\": 273,\n \"description\": \"string\"\n}\n\nFor this method, the following fields are required:
\ncellphone
whatsappAccountId
For this method, the following fields are optional:
\npdfUrl (must use HTTPS; resource must be publicly accessible without authentication; referenced file must be a valid PDF and not exceed 100 MB)
templateName
\n\nNote: By default, collection messages are sent from Refacil's WhatsApp line.
\n
To send them from your own line, you must first link your WhatsApp account in the administrative portal and obtain the correspondingwhatsappAccountId.
Once linked, collection messages will be sent from the client's WhatsApp line.
\"paymentMethod\": {\n \"id\": 277, // required\n \"cellphone\": \"string\", // required\n \"pdfUrl\": \"string\", // optional\n \"whatsappAccountId\": \"string\", // required\n \"templateName\": \"string\" // optional\n}\n\nThe services that you will see below are the ones that will allow you to generate a payment resource depending on your needs.
\nPayment link (Gateway with all payment methods).
\nPayment method (Specific payment method).
\n\n\n🔐 Authentication
\n
All requests must include the following headers:
\nThis endpoint allows you to generate withdrawal (cash-out) requests through the available payout methods.
\nThe table below lists the available payout methods along with their corresponding IDs and brief descriptions.
\n\n\n⚠ Note:
\n
Each withdrawal method requires a specific object structure within the\"withdrawMethod\"field, as shown below.
\"withdrawMethod\": {\n \"id\": 264,\n \"key\": \"@REPRUEBAL7717\"\n}\n\nDescription:
Transfers funds directly to a Bre-B account using the beneficiary’s unique Bre-B key.
\n\n💡 Tip:
\n
Thekeyfield must contain a valid Bre-B account alias in the format@USERNAME.
This service allows you to consult the balance exchange and the dispersion exchange associated with the client's identifier.
\n\n\nTo use the service, an authentication token is required, which must be sent as an Authorization header.
\n
Headers
\nBody
\n","urlObject":{"protocol":"{{protocol}}","path":["customer","getBalance"],"host":["{{serverNamePayApi}}"],"query":[],"variable":[]}},"response":[{"id":"b3f5220f-57d6-4894-8116-19531706196f","name":"200: Ok Successful","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-transaction-token","value":"{{transactionalToken}}"},{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"userId\": 1085718\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"107"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:17:25 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"6b-0dCGoZWHzsNFKqnQWZCYbct/JaY\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains; preload"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Cache-Control","value":"no-cache"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"CXZ2m9SOeqNyF_xQbqGXkHDA8Ora3unN419YKniR4GCxN5CsgRANEA=="}],"cookie":[],"responseTime":null,"body":"{\n \"bags\": [\n {\n \"bag\": \"Saldo de dispersión\",\n \"amount\": \"9823225.00\"\n },\n {\n \"bag\": \"Bolsa de Multiproducto\",\n \"amount\": \"10104980.00\"\n }\n ],\n \"date\": \"29/08/2024 15:18:47\"\n}"},{"id":"ed5fa67c-5e42-4f95-a704-cee05fd69f22","name":"400: Invalid User","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-transaction-token","value":"{{transactionalToken}}"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"userId\": 1085718\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"136"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:57 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"88-bwrowifrUlJgfsEZM/enGjUQtLc\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"MSC3fgs7xlHyD1mZJrcWZW3nojCkBGwO7vI3F6ZTJa1YcCUO58DeYw=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"errorCode\": \"server.error\",\n \"message\": \"Ocurrió un error al consultar las bolsas\",\n \"date\": 1724962461988\n}"},{"id":"c43814a9-1e06-4cb6-ab4a-ef31ee8de330","name":"401: Authentication error","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"},{"key":"Content-Type","value":"application/json"},{"key":"x-transaction-token","value":"{{transactionalToken}}"}],"body":{"mode":"raw","raw":"{\r\n \"userId\": 1085718\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"134"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:03 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"86-kcBuGThx4cPlprzs2xpVmJyz7fI\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"vQVNdZnlAF2O2YPtMv10xMZ2OJNvefoOIsh3FXaEXJqsT56hiy-GNA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Error en la autenticación\",\n \"date\": 1730492283161\n}"},{"id":"f5be124b-ac20-40b8-85ad-5f81460e464f","name":"401: Authentication not found","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-transaction-token","value":"{{transactionalToken}}"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"userId\": 1085718\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"136"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:57 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"88-bwrowifrUlJgfsEZM/enGjUQtLc\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"MSC3fgs7xlHyD1mZJrcWZW3nojCkBGwO7vI3F6ZTJa1YcCUO58DeYw=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Autenticación no encontrada\",\n \"date\": 1730492337196\n}"}],"_postman_id":"f80f9c28-3e29-4173-89bb-4f42f7e1195b"}],"id":"750b1f79-ec6f-40e2-b692-3e13bc6b7662","description":"This service allows you to generate withdrawal requests through the enabled dispersion means.
\n\n\n🔐 Authentication
\n
All requests must include the following headers:
\n\n\n","_postman_id":"750b1f79-ec6f-40e2-b692-3e13bc6b7662"},{"name":"Payment information","item":[{"name":"Transaction Summary","item":[],"id":"138e1363-b285-4620-bf93-e03ed539d967","description":"Important fields within the requests:
\n
Webhook: This is the url of the client's webhook to where our service sends the transaction status and transaction detail information.
This section describes the mandatory structure and behavior of the transaction summary screen that API clients must implement when showSummary is set to false.
The purpose of this guide is to ensure a consistent and standardized experience across all integrations.
Use a vertical column layout with labels and values aligned for clarity.
\nLocated below the total block, centered, with sufficient spacing.
\nThe transaction receipt must appear immediately after the payment attempt, whether the result is successful, pending, or rejected.
\nThe displayed status must reflect the final response received from the payment provider or channel.
\nThe transaction receipt must remain available for later consultation or download (where applicable).
\nFor all PSE and PSE Gateway transactions, the API client MUST make a request to the Transaction status service as soon as the end user reaches the custom transaction summary page implemented by the client.
This call is required to obtain the final payment status and ensure proper synchronization with PSE transaction confirmation.
\n\n","_postman_id":"138e1363-b285-4620-bf93-e03ed539d967"},{"name":"Transaction status","id":"e643a77d-8a58-4414-9ae9-454ef6e312e6","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\n \"reference\": \"12442830-7afb-11ed-b265-b9457b46***3\"\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNamePayApi}}/payment/status","description":"Example Behavior:
\n
After the payment is completed in the PSE interface, the user is automatically redirected to the URL specified inreturnUrl.
Upon loading that page, your system must immediately call the Transaction status using the transaction reference to confirm and display the definitive status of the transaction.
This service allows you to check the status of a transaction made, for this you must have the reference data that returned the response when generating any payment resource.
\nIn the response you will get the status id which will mean the following
\n0 - Transaction Rejected
\n1 - Pending Transaction
\n2 - Transaction Approved
\n3 - Failed Transaction
\n5 - Transaction Cancelled
\n9 - Processing Transaction
\nHeaders
\nBody
\n","urlObject":{"protocol":"{{protocol}}","path":["payment","status"],"host":["{{serverNamePayApi}}"],"query":[],"variable":[]}},"response":[{"id":"aaf3cc81-0f16-42f1-b30a-4266472c6187","name":"200: Ok Successful","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-transaction-token","value":"{{transactionalToken}}"},{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"12442830-7afb-11ed-b265-b9457b46***3\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"107"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:17:25 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"6b-0dCGoZWHzsNFKqnQWZCYbct/JaY\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains; preload"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Cache-Control","value":"no-cache"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"CXZ2m9SOeqNyF_xQbqGXkHDA8Ora3unN419YKniR4GCxN5CsgRANEA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": \"00\",\n \"message\": \"Operación exitosa.\",\n \"data\": {\n \"id\": \"1342\",\n \"cost\": \"$1,190.00\",\n \"status\": \"1\",\n \"date\": \"2022-12-13T10:22:34.775Z\",\n \"providerReference\": \"8495\",\n \"amount\": \"$18,000.00\",\n \"description\": null,\n \"paymentMethod\": null,\n }\n}"},{"id":"22df1e7f-88c1-4846-a136-2aa5672230c3","name":"401: Authentication error","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"},{"key":"Content-Type","value":"application/json"},{"key":"x-transaction-token","value":"{{transactionalToken}}"}],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"12442830-7afb-11ed-b265-b9457b46***3\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"134"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:03 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"86-kcBuGThx4cPlprzs2xpVmJyz7fI\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"vQVNdZnlAF2O2YPtMv10xMZ2OJNvefoOIsh3FXaEXJqsT56hiy-GNA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Error en la autenticación\",\n \"date\": 1730492283161\n}"},{"id":"1a69c1ee-fe71-4fcd-b8c8-9167aa4e8792","name":"401: Authentication not found","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-transaction-token","value":"{{transactionalToken}}"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"12442830-7afb-11ed-b265-b9457b46***3\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"136"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:57 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"88-bwrowifrUlJgfsEZM/enGjUQtLc\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"MSC3fgs7xlHyD1mZJrcWZW3nojCkBGwO7vI3F6ZTJa1YcCUO58DeYw=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Autenticación no encontrada\",\n \"date\": 1730492337196\n}"}],"_postman_id":"e643a77d-8a58-4414-9ae9-454ef6e312e6"},{"name":"Transaction status - Custom Reference","id":"2a47b441-1a1d-436f-99f2-820669232c19","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\n \"customerReference\": \"12442830-7afb-11ed-b265-b9457b46***3\"\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNamePayApi}}/payment/customer-reference/status","description":"This endpoint allows API Pay users to query the status of a transaction using only the customerReference value originally provided when generating a resource as reference1 through any of the following endpoints:
/cash-in/generate/payment-link/token
/cash-in/generate/payment-method/token
/cash-out/generate/withdraw-method/token
This service is useful for retrieving the internal Refacil transaction information associated with a previously submitted customer reference.
\nThis endpoint requires a valid Bearer Token in the request headers. Requests without valid authentication will be rejected with an Unauthorized error.
exists: true indicates that the transaction associated with the provided customerReference was found.
id: Internal Refacil transaction ID.
status: Transaction status code (see table below).
reference: Full Refacil transaction reference, which can be used to query /payment/status.
This service allows you to consult the necessary characteristics of a payment method to successfully generate a resource. For example, obtain the PSE banks
\nHeaders
\nBody
\n","urlObject":{"protocol":"{{protocol}}","path":["payment","features"],"host":["{{serverNamePayApi}}"],"query":[],"variable":[]}},"response":[{"id":"c252cd0a-6f51-4591-bd34-278ba327df4b","name":"200: Ok Successful","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-transaction-token","value":"{{transactionalToken}}"},{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id\": 133\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"107"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:17:25 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"6b-0dCGoZWHzsNFKqnQWZCYbct/JaY\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains; preload"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Cache-Control","value":"no-cache"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"CXZ2m9SOeqNyF_xQbqGXkHDA8Ora3unN419YKniR4GCxN5CsgRANEA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": \"00\",\n \"message\": \"Operación exitosa.\",\n \"data\": {\n \"banks\": [\n {\n \"id\": \"0\",\n \"name\": \"A continuación seleccione su banco\"\n },\n {\n \"id\": \"1552\",\n \"name\": \"BAN.CO\"\n },\n {\n \"id\": \"1059\",\n \"name\": \"BANCAMIA\"\n },\n {\n \"id\": \"1040\",\n \"name\": \"BANCO AGRARIO\"\n },\n {\n \"id\": \"1081\",\n \"name\": \"BANCO AGRARIO DESARROLLO\"\n }\n } \n \n }\n"},{"id":"aa598f26-1b2f-4697-956e-22e65149abf8","name":"401: Authentication error","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"},{"key":"Content-Type","value":"application/json"},{"key":"x-transaction-token","value":"{{transactionalToken}}"}],"body":{"mode":"raw","raw":"{\r\n \"id\": 133\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"134"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:03 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"86-kcBuGThx4cPlprzs2xpVmJyz7fI\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"vQVNdZnlAF2O2YPtMv10xMZ2OJNvefoOIsh3FXaEXJqsT56hiy-GNA=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Error en la autenticación\",\n \"date\": 1730492283161\n}"},{"id":"61d708a4-16f6-447c-9f3f-ecc48168c564","name":"401: Authentication not found","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-transaction-token","value":"{{transactionalToken}}"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\r\n \"id\": 133\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pay-api.qa.refacil.co/trx-token/generate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"136"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 01 Nov 2024 20:18:57 GMT"},{"key":"X-Powered-By","value":""},{"key":"ETag","value":"W/\"88-bwrowifrUlJgfsEZM/enGjUQtLc\""},{"key":"Server","value":"refacil.com"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"Permissions-Policy","value":"geolocation=(self)"},{"key":"Vary","value":"Origin"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 9731114c592d557eb8c861bd3ffa9908.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"CMH68-P2"},{"key":"X-Amz-Cf-Id","value":"MSC3fgs7xlHyD1mZJrcWZW3nojCkBGwO7vI3F6ZTJa1YcCUO58DeYw=="}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 401,\n \"errorCode\": \"server.error\",\n \"message\": \"Autenticación no encontrada\",\n \"date\": 1730492337196\n}"}],"_postman_id":"cd1221a0-8bf4-4922-a866-2cebd9c402ee"}],"id":"6a757665-08eb-491b-9295-10aadf558777","description":"These services will allow us to validate the status of a transaction and consult the characteristics of a payment method.
\n","_postman_id":"6a757665-08eb-491b-9295-10aadf558777"},{"name":"Webhook Notification","item":[{"name":"Structure and example of webhook request","id":"d21558ca-7d3f-453e-bc06-6778b7273f8b","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {{tokenLogin}}"}],"body":{"mode":"raw","raw":"{\n \"reference\": \"12442830-7afb-11ed-b265-b9457b46***3\"\n}","options":{"raw":{"language":"json"}}},"url":"{{protocol}}://{{serverNamePayApi}}/webhook/notify","description":"Body
\nThis component must be built by the merchant to receive the transaction notification data.
\nYou must take into account the following steps:
\n**1.**You must create a Webhook without authentication.
\n2. The Url created will be the one you send in all requests when generating the payment resource in the “_WebhookUrl_” field. It is important to keep in mind that if for some reason you change the webhook you must modify the urls that you send in each generated resource.
\nA signature must be generated to validate the integrity of the messages sent to the webhook and the fields must be concatenated in the following way:
\nHASH_KEY =This data must be requested to the support area.
\nlet signature = referenceId-resourceId-amount-updatedAt-HASH_KEY; signature = crypto.createHmac(“sha1”, HASH_KEY).update(signature).digest(“hex”);
\nExample of a response that will reach your Webhook
\nResponse
\n{\n \"realAmount\": 20000,\n \"amount\": 19405,\n \"cost\": \"$595.00\",\n \"referenceId\": \"38**\",\n \"moduleId\": 9,\n \"productId\": 117,\n \"referenceKey\": \"3538d790-ae14-11ed-be2d-4d9b1bc987e6\",\n \"paymentMethod\": \"PSE\",\n \"userId\": 189067,\n \"resourceId\": \"10024**\",\n \"updatedAt\": \"2023-02-16 11:11:55\",\n \"providerId\": 8,\n \"providerReference\": \"3122330\",\n \"reference1\": \"435sdfsd**\",\n \"reference2\": {\n \"Label\": {\n \"Information\": \"Por seguridad algunos datos se encuentran cifrados\",\n \"Name\": \"L**A\",\n \"Email\": \"l**am@**\",\n \"CellPhone\": \"3**4\",\n \"DocumentType\": \"C\",\n \"DocumentNumber\": \"52019859\",\n \"Description\": \"Abono\",\n \"Commerce\": \"Skandia\",\n \"Reference1\": null,\n \"Reference2\": null,\n \"Reference3\": null\n },\n \"Data\": {\n \"ConciliationCode\": \"FCO\",\n \"ConciliationContract\": \"1277840\",\n \"DocType\": \"N\",\n \"DocNumber\": \"800194363\"\n },\n \"returnUrl\": \"https://www.google.com/\"\n },\n \"bankId\": \"1022\",\n \"bankName\": \"BANCO UNION COLOMBIANO\",\n \"status\": 2,\n \"sign\": \"aa2f472ad7e84524a02d1716b56fc16ec2a87***\",\n \"error\": {\n \"code\": \"20-07A\",\n \"message\": \"Error técnico en Lambda\"\n }\n}\n\nWithin the webhook an \"error ” object is sent that shows the error code and message associated with rejections received from the supplier/bank or cancellation of the transaction when the generation of the resource is not completed.
\nThe error codes are printed when the transaction is Rejected by the bank or when it is Cancelled because the resource generation could not be completed.
\nNotification for Withdraw
\nFor withdraws, a notification will be sent to the webhook provided in the application. This notification will follow the structure mentioned above and will additionally include the withdrawal data. An example is provided below:
\n{\n ...\"webhook\",\n \"withdraw\": {\n \"id\": \"1403**\",\n \"transactionId\": \"5690**\",\n \"userId\": 189067,\n \"providerReference\": \"3122330\",\n \"accountNumber\": \"3051000002\",\n \"accountId\": null,\n \"createdAt\": \"2023-02-16 11:10:55\",\n \"updatedAt\": \"2023-02-16 11:12:55\",\n \"deletedAt\": null,\n \"infoReference\": \"435sdfsd**\",\n \"observation\": null\n },\n}\n\n\n\n","_postman_id":"124620cd-4caa-4d5a-b2a9-64a0b7bb873e"},{"name":"Providers - Test environment","item":[],"id":"cb1f3d89-570c-4e52-9c51-e3e955f40ca9","description":"The implementation of the webhook by the API user is mandatory. The reception and storage of the information for the reconciliation process by the API user with RefácilPay must be ensured.****__This item will be evaluated during the certification process and will be mandatory for the transition to Production.
\n
In this section, you will find information about the providers that you can use in test environment to perform the complete payment flow.
\nIt is possible to perform a complete payment flow, either by generating a payment link or by generating a direct payment.
\nTo generate a payment link, it is necessary to use the “Generate Payment Link” service, detailed in the Payment section.
\nOnce the resource with the payment link is generated, you can access the link provided in the service response, in the url field. By accessing this link, it is possible to select among the payment methods offered by RefácilPay. Below is detailed how to complete the payment process for the payment methods available in the test environment.
PSE
\nSelect the Bank: Start the payment process by choosing \"Banco Unión Colombiano ” as the financial entity.
\nEnter your Personal Data: Complete the form with your personal data required to continue with the transaction.
\nPayment Simulation: During the payment simulation, you will be asked to enter three specific pieces of information. This data allows you to complete the test flow properly.
\nBancolombia BNPL (Compra y Paga Después)
\nSelect the Payment Method: Start the payment process by choosing the \"Compra y Paga Después ” bank as your payment option.
\nEnter your Personal Data: Complete the form with your personal data required to continue with the transaction.
\nQuota Validation: The system will validate if the client has an available quota to request the loan corresponding to the payment.
\nUser Login: The login process begins in direct experience with Bancolombia.
\n\n\nMinimum Amount: Be sure to enter a minimum amount of $100,000 to use this payment method.
\n
Validate if the client has available credit to request the loan payment.
\nTo generate a resource with a payment method, use the \"Generate Payment Method\" service as detailed in the Payments section.
\nThe simulation allows testing both successful and failed flows by using specific cellphone numbers in the request. These numbers are applicable for collection (P2B) transactions using Nequi and Daviplata.
\nUse +573051000090 to simulate a payment that is processed successfully. This is useful to validate expected behaviors in a successful collection scenario.
Use +573051000080 to simulate a rejected collection transaction. This allows testing how the system handles unsuccessful flows.
Important: After consuming the payment method generation service, the user MUST notify Refacil of this action. The final response time may vary depending on asynchronous notifications between Refacil and the provider.
\nSuggestion for Testing:
\nIn all test scenarios, we recommend using low transaction amounts when generating resources in the STG environment. This helps avoid rejections due to possible fraud detection mechanisms triggered by high-value test transactions.
\nTo test the card payment method (ID: 273), you can use the following test cards to simulate different authorization, approval, and rejection scenarios within the payment processing system.
\nThe following test card numbers can be used to simulate successful transactions.
\nThese test card numbers simulate rejection scenarios.
\nNote: These test cards are only available in the test environment (QA/Sandbox) and should not be used in production.
\nTo test the generation of withdraw resources, use the Withdraw section configuration and the test numbers below. These flows simulate B2P (withdraw) transactions with successful and failed outcomes based on the number used.
\nUse +573051000002 to simulate a successful withdraw, allowing validation of the correct flow.
Use +573002491283 to simulate a rejected withdraw. This helps ensure the system correctly handles and responds to errors in the process.
Important: For each withdraw request, the user must notify Refacil of the consumption. Response times may vary due to interactions between Refacil and the provider.
\nSuggestion for Testing:
\nIn all test scenarios, we recommend using low transaction amounts when generating withdraws in the STG environment. This helps avoid false positives related to fraud prevention systems during testing.
\nP2B: Payment from a person to a business. Also referred to as payment method generation or recapture.
\nB2P: Payment from a business to a person. Also referred to as scatter.
\nThis section provides a detailed guide for the integration of eCommerce and online stores with RefácilPay. The system enables simple and efficient integration, offering customers a secure, fast and hassle-free payment experience.
\nSteps to follow for integration
\nStore registration: Create an account and complete the initial setup.
\nObtain API consumption token: Generate and save the API credentials required for the integration.
\nAPI consumption: Follow the technical integration guide to use the services provided by RefácilPay.
\nStore registration
\nTo complete this step, it is necessary to build a URL with certain input parameters that will allow the linking of the eCommerce with RefácilPay. The URL structure must follow the following format:
\n\n\n\n
Test enviroment:
\n\n\n\n
URL parameters
\nOnce the URL has been generated with the necessary parameters, the URL must be entered in the search bar of a browser. This will initiate the eCommerce self-registration process to obtain a user. During this process, the necessary data will be configured and the access credentials to the platform will be obtained.
\nObtain API consumption token
\nAfter completing the self-registration, the data provided will be validated and verified to confirm the identity of the registration. Once this validation process has been completed and the identity has been successfully verified, an email will be sent informing about the successful integration and the token will be sent to the URL specified in the returnurl parameter.
The token will be sent by means of a HTTPS POST request with the following format:
\nPOST {{returnurl}}
Headers
\nFields (Body)
\nRequest
\n{\n \"token\": \"MTY4ODQ5NzUyMTk4MSQyYiQxMCRsWlhiU2lkRE0vczdYTkJBcWpENVhPZHhiUGIyVXR3akE5U2RFbjJJRGNPTVQ3TkMvcGRiSw==\",\n \"storeId\": \"12345\",\n}\n\nAPI Consumption
\nOnce the self-registration is completed and the token is obtained, you will be able to use the services provided by the API. To generate a payment resource, follow the flow below:
\nObtain Transactional Token
\nGenerate resource with Payment Link
\n\n\nFor resources generated from the eCommerce integration, the following data must be included in the reference2 field:
\n
Within the Commerce object, the data corresponding to the eCommerce ID provided by RefacilPay and the store ID must be included.
Example
\n{\n \"expiresIn\": 0,\n \"amount\": 18000,\n \"brandId\": 61,\n \"webhookUrl\": \"https://****gerstg.azure-api.net/SkCo.PagosEnLinea.API/payonline/PostStatus\",\n \"returnUrl\": \"https://www.google.com/\",\n \"showSummary\": true,\n \"reference1\": \"CGOOsiYQspMpgDD\",\n \"reference2\": {\n \"Label\": {\n \"Name\": \"Juanita Perez\",\n \"Email\": \"pqacLO87V77DgF62P8PXENA==do\",\n \"CellPhone\": \"1VM6daPPJcXCD4Cw93272oQ==8\",\n \"PersonType\": \"N\",\n \"DocumentType\": \"C\",\n \"DocumentNumber\": 79706920\n },\n \"Commerce\": {\n \"origin\": 1,\n \"storeId\": \"12345\"\n }\n }\n}\n\nThis endpoint retrieves the merchant's enrollment details after the enrollment process has been completed. It provides necessary information to use the QR interoperable payment method.
\n","urlObject":{"protocol":"{{protocol}}","path":["merchant","enrollment-data"],"host":["{{serverNamePayApi}}"],"query":[],"variable":[]}},"response":[{"id":"29eba2dc-e2fa-4a29-9ec2-94bc459f8ea0","name":"approved","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"url":"https://pay-api.qa.refacil.co/merchant/enrollment-data"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 14 Mar 2025 19:16:15 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"169"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"ETag","value":"W/\"a9-QRf+dAkA4/vdKTNCJdSnX6n5kS8\""}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": \"00\",\n \"message\": \"Éxito\",\n \"data\": {\n \"status\": \"approved\",\n \"isEnrolled\": true,\n \"cellphone\": \"3888000003\",\n \"merchantId\": \"936641111\",\n \"documentNumber\": \"1000100100\",\n \"company\": \"FELIPE LONDOÑO\"\n }\n}\n"},{"id":"d2cef3d4-1b29-4746-95cc-7286221a1424","name":"rejected","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"url":"https://pay-api.qa.refacil.co/merchant/enrollment-data"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"statusCode\": \"03\",\r\n \"message\": \"Comercio rechazado en el proceso de enrolamiento\",\r\n \"data\": {\r\n \"status\": \"rejected\",\r\n \"isEnrolled\": false,\r\n \"cellphone\": \"3888000003\",\r\n \"merchantId\": null,\r\n \"documentNumber\": null,\r\n \"company\": null\r\n }\r\n}\r\n"},{"id":"91238ef9-1665-41e1-8cae-364cd3525146","name":"not_started","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"url":"https://pay-api.qa.refacil.co/merchant/enrollment-data"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"statusCode\": \"03\",\r\n \"message\": \"No se ha iniciado el proceso de enrolamiento para el comercio\",\r\n \"data\": {\r\n \"status\": \"not_started\",\r\n \"isEnrolled\": false,\r\n \"cellphone\": null,\r\n \"merchantId\": null,\r\n \"documentNumber\": null,\r\n \"company\": null\r\n }\r\n}"},{"id":"494c973d-6378-40d2-8015-ab909e1bbe34","name":"enrolled_other","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"url":"https://pay-api.qa.refacil.co/merchant/enrollment-data"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"statusCode\": \"03\",\r\n \"message\": \"Comercio enrolado en otra entidad\",\r\n \"data\": {\r\n \"status\": \"enrolled_other\",\r\n \"isEnrolled\": false,\r\n \"cellphone\": null,\r\n \"merchantId\": null,\r\n \"documentNumber\": null,\r\n \"company\": null\r\n }\r\n}"},{"id":"11e97d1f-6da5-4ece-bfb0-57ac0c44b7c5","name":"pending","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"url":"https://pay-api.qa.refacil.co/merchant/enrollment-data"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"statusCode\": \"03\",\r\n \"message\": \"Comercio pendiente de aprobación para finalizar el enrolamiento\",\r\n \"data\": {\r\n \"status\": \"pending\",\r\n \"isEnrolled\": false,\r\n \"cellphone\": null,\r\n \"merchantId\": null,\r\n \"documentNumber\": null,\r\n \"company\": null\r\n }\r\n}\r\n"}],"_postman_id":"a192bb3d-efb5-4fec-85b1-2030d7a8facf"}],"id":"ee5d64d2-5702-41c3-9469-69bee7c8d7e3","description":"This service allows merchants to retrieve enrollment data for the use of the QR interoperable payment method and key creation.
\nTo use the service, an authentication token is required and must be sent as an Authorization header.
Retrieve Enrollment Data
\napproved
The merchant has been approved and is authorized to generate QR codes.
\nenrolled_other
The merchant is already enrolled with another entity. To proceed:
\nContact the commercial representative and request unenrollment from the current entity.
\nSubmit a letter signed by the legal representative.
\nBe aware that this process may take up to 5 business days.
\nThe commercial representative will provide guidance throughout the process.
\nrejected
The merchant has been rejected. Please contact your commercial representative for further details.
\npending
The enrollment is in progress. The query may take a few minutes. If a final status is not received shortly, contact RefacilPay support to verify the situation.
\nnot_started
No enrollment process has been initiated for the requested merchant.
\nDuring the merchant creation flow for the QR Interoperable product, the API retrieves the merchant's registered information from the system. However, for the \"cellphone number\" field, the Refacil system automatically replaces the merchant’s actual phone number with a generic alias number.
\nThis behavior follows technical and operational requirements from the provider, as the real phone number may already exist in the provider’s databases, potentially causing integration conflicts.
\nTo avoid these issues, a randomly generated alias is used as a placeholder. This alias is exclusive to this product and does not affect the merchant’s operation in other services.
\n","_postman_id":"ee5d64d2-5702-41c3-9469-69bee7c8d7e3"},{"name":"Webhook Backup Management","item":[{"name":"List user webhooks","id":"435b0dcb-8967-4b43-890e-018e61a94e64","request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"}],"url":"{{protocol}}://{{serverNamePayApi}}/user-webhooks","description":"Returns the backup webhooks configured for the authenticated user. The user is identified by the Bearer token (header Authorization). The response lists all webhooks for that user with their type (e.g. Saldo, Dispersión), URL and active/inactive status.
Query which backup webhook URLs the authenticated client has configured.
\nSee the status (active/inactive) of each webhook.
\nList available webhook types (Saldo, Dispersión).
\nstatusCode (string): Operation status code. 00 = success.
message (string): Descriptive message (e.g. \"Operación exitosa.\").
\ndata (array): List of webhooks, each with: id, userId, webhookTypeId, typeName, url, active, createdAt, updatedAt.
GET {{protocol}}://{{serverNamePayApi}}/user-webhooks\nAuthorization: Bearer {{tokenLogin}}\n\nResponse body:
\n{\n \"statusCode\": \"00\",\n \"message\": \"Operación exitosa.\",\n \"data\": [\n {\n \"id\": 1,\n \"userId\": 12345,\n \"webhookTypeId\": 1,\n \"typeName\": \"Saldo\",\n \"url\": \"https://my-server.com/webhooks/saldo\",\n \"active\": true,\n \"createdAt\": \"2025-01-15T10:00:00.000Z\",\n \"updatedAt\": \"2025-01-15T10:00:00.000Z\"\n },\n {\n \"id\": 2,\n \"userId\": 12345,\n \"webhookTypeId\": 2,\n \"typeName\": \"Dispersión\",\n \"url\": \"https://my-server.com/webhooks/dispersion\",\n \"active\": false,\n \"createdAt\": \"2025-01-14T08:30:00.000Z\",\n \"updatedAt\": \"2025-01-16T14:20:00.000Z\"\n }\n ]\n}\n\nWhen the user has no webhooks configured, data is an empty array:
{\n \"statusCode\": \"00\",\n \"message\": \"Operación exitosa.\",\n \"data\": []\n}\n\nCreates a backup webhook for a user and webhook type. When a new webhook is created, only this webhook remains active for that user and type; others of the same type are deactivated.
\nwebhookRequest.webhookTypeIdPOST {{protocol}}://{{serverNamePayApi}}/user-webhooks\nAuthorization: Bearer {{tokenLogin}}\nContent-Type: application/json\n{\n \"webhookTypeId\": 2,\n \"url\": \"https://my-server.com/webhooks/dispersion\"\n}\n\nThe user is inferred from the Bearer token; do not send userId in the body.
Response body:
\n{\n \"statusCode\": \"00\",\n \"message\": \"Operación exitosa.\",\n \"data\": {\n \"id\": 3,\n \"userId\": 12345,\n \"webhookTypeId\": 2,\n \"url\": \"https://my-server.com/webhooks/dispersion\",\n \"active\": true,\n \"createdAt\": \"2025-01-16T12:00:00.000Z\",\n \"updatedAt\": \"2025-01-16T12:00:00.000Z\"\n }\n}\n\nWhen webhookTypeId is not an allowed value (only 1 and 2 are valid), the API returns:
{\n \"statusCode\": 404,\n \"message\": \"Webhook type not found: 99\",\n \"error\": \"Not Found\"\n}\n\nWhen the request body is invalid (e.g. missing required fields, invalid URL format), the API returns validation errors:
\n{\n \"statusCode\": 400,\n \"message\": [\n \"url must be a URL address\",\n \"url must be a URL address\"\n ],\n \"error\": \"Bad Request\"\n}\n\nUpdates the active/inactive status of a backup webhook owned by the authenticated user. The user is identified by the Bearer token; you can only update webhooks that belong to that user. If a webhook is activated, other webhooks for the same user and type are deactivated (only one active per type per user).
\nActivate or deactivate a backup webhook URL without deleting it.
\nSwitch which URL receives notifications when multiple are configured (activating one deactivates others of the same type).
\nPATCH {{protocol}}://{{serverNamePayApi}}/user-webhooks/1/status\nAuthorization: Bearer {{tokenLogin}}\nContent-Type: application/json\n{\n \"active\": true\n}\n\nResponse body:
\n{\n \"statusCode\": \"00\",\n \"message\": \"Operación exitosa.\",\n \"data\": {\n \"id\": 1,\n \"userId\": 12345,\n \"webhookTypeId\": 1,\n \"url\": \"https://my-server.com/webhooks/saldo\",\n \"active\": true,\n \"createdAt\": \"2025-01-15T10:00:00.000Z\",\n \"updatedAt\": \"2025-01-16T15:30:00.000Z\"\n }\n}\n\nWhen no webhook exists with the given id, the API returns:
{\n \"statusCode\": 404,\n \"message\": \"User webhook not found: 999\",\n \"error\": \"Not Found\"\n}\n\nWhen the webhook does not belong to the authenticated user, the API returns:
\n{\n \"statusCode\": 403,\n \"message\": \"Webhook does not belong to the authenticated user\",\n \"error\": \"Forbidden\"\n}\n\nWhen id is not a valid number or body is invalid:
{\n \"statusCode\": 400,\n \"message\": \"Validation failed (numeric string is expected)\",\n \"error\": \"Bad Request\"\n}\n\nWebhook identifier
\n","type":"text/plain"},"type":"any","value":"1","key":"id"}]}},"response":[{"id":"4b3a0bb9-f0a7-4612-99e9-14b6f4a0b2e3","name":"200 OK - Status updated","originalRequest":{"method":"PATCH","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"active\": true\n}"},"url":"{{serverNamePayApi}}/user-webhooks/1/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": \"00\",\n \"message\": \"Operación exitosa.\",\n \"data\": {\n \"id\": 1,\n \"userId\": 12345,\n \"webhookTypeId\": 1,\n \"url\": \"https://my-server.com/webhooks/saldo\",\n \"active\": true,\n \"createdAt\": \"2025-01-15T10:00:00.000Z\",\n \"updatedAt\": \"2025-01-16T15:30:00.000Z\"\n }\n}\n"},{"id":"16a06204-75b6-4372-8f75-fe0665b5b8f4","name":"404 Not Found - User webhook not found","originalRequest":{"method":"PATCH","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"active\": true\n}"},"url":"{{serverNamePayApi}}/user-webhooks/999/status"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 404,\n \"message\": \"User webhook not found: 999\",\n \"error\": \"Not Found\"\n}\n"},{"id":"29e62e83-eaa7-47c7-a6cd-dde306bb1709","name":"400 Bad Request - Invalid id","originalRequest":{"method":"PATCH","header":[{"key":"Authorization","value":"Bearer {{tokenLogin}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"active\": true\n}"},"url":"{{serverNamePayApi}}/user-webhooks/abc/status"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 400,\n \"message\": \"Validation failed (numeric string is expected)\",\n \"error\": \"Bad Request\"\n}\n"}],"_postman_id":"78f0a3ea-8206-4667-9b18-0168233788ee"}],"id":"d8acc75b-e1da-48a8-aa11-c2effd916196","description":"Service to configure backup webhooks per client. It allows listing, creating and activating/deactivating URLs to which RefacilPay will send notifications when the payment resource has no webhook configured (e.g. for Saldo or Dispersión).
\nList user webhooks (GET) – Returns the backup webhooks configured for the authenticated user (user inferred from Bearer token).
\nCreate user webhook (POST) – Creates a backup webhook for the authenticated user and type (Saldo or Dispersión).
\nUpdate webhook status (PATCH) – Activates or deactivates a backup webhook owned by the authenticated user.
\nAll endpoints require Bearer token authentication (Authorization: Bearer {{tokenLogin}}). The user is always inferred from the token for security.
Welcome to Refácil Pay in this space you will find all the information to make a successful connection and all the operational processes that we offer.
\n\n\nYou will be able to target the consumption of our services through our following Endpoint :
\n
QA: https://pay-api.qa.refacil.co/
Producción: https://pay-api.refacil.co/
\n\nNote: It should be noted that for each environment only the beginning of the Url is modified, the subsequent address is the same for both environments in the services that you will consume.
\n
\n\n","_postman_id":"bffa2c0d-6d0c-48c4-99ee-e5ff28440e77"},{"name":"Collection API","item":[{"name":"Authorization","item":[{"name":"Generate JWT Authorization Token","id":"88e32697-0418-41b0-8cb6-f57b7de5c2f0","request":{"method":"GET","header":[{"key":"x-secret-id","value":"64c0f2660d7b59d35197e5c77a5543c1aaf94c17************","type":"text"}],"url":"https://collection-api.qa.refacil.co/auth/jwt","description":"API implementation credentials in test environment will be available throughout the integration and up to 30 days after certification in production.
\n
This endpoint allows third-party clients to generate a temporary JWT Bearer token using their assigned Secret ID.
\nThe token is required to authenticate and access protected endpoints in the Collection API.
\nThe token is valid for 60 minutes.
\nYou must include the x-secret-id header to request it.
This endpoint generates a single-use token that provides an extra layer of security for sensitive operations.
\nThe token is valid for 60 seconds and can only be used once.
\nYou must include both x-secret-id and Authorization: Bearer headers to request it.
To use the Collection API, clients must follow a two-step authentication process:
\nGenerate a JWT (Bearer Token) using their Secret ID
\n(Optional) Generate a One-Time Token (OTT) for secure access to specific endpoints
\nEach request must include the correct headers. Tokens have time-based expiration.
\n","_postman_id":"8b780292-7274-40cf-932d-a2a21c3f2247"},{"name":"Payments","item":[{"name":"Submit Payment","event":[{"listen":"test","script":{"exec":["// Test para todas las posibles respuestas","pm.test(\"Status code is handled\", function () {"," pm.expect(pm.response.code).to.be.oneOf([200, 400]);","});","","// Test para respuesta exitosa","pm.test(\"Successful transaction\", function () {"," if (pm.response.code === 200) {"," pm.expect(pm.response.text()).to.equal(\"0\");"," }","});","","// Test para todos los casos de error","pm.test(\"Error responses\", function () {"," if (pm.response.code === 400) {"," pm.expect(pm.response.text()).to.be.oneOf(["," '(\"201\", \"\", \"Campos malformados\")',"," '(\"103\", \"\", \"Valor incorrecto\")',"," '(\"101\", \"\", \"Cliente no encontrada\")',"," '(\"203\", \"\", \"Empresa no encontrada\")',"," '(\"901\", \"\", \"Error desconocido\")'"," ]);"," }","});"],"type":"text/javascript","packages":{}}}],"id":"91a8401b-5bf9-42e7-9342-77691085efc4","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-secret-id","value":"64c0f2660d7b59d35197e5c77a5543c1aaf94c17************","type":"text"},{"key":"Authorization","value":"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiUGlwZSBUZXN0IiwiY3VzdG9tZXJJZCI6NzgyLCJpYXQiOjE3NTE4OTc5MzUsImV4cCI6MTc1MTkwMTUzNX0.dHKl4DduA8ySqG2KkSVoGWLi0IujplL0olDopsUR4L_bQXhJKBfTg98JukRd8JpOXSOtKwy6TgPiiLA7AMFedbthfkAR_fFBw7Bxvr88vIMfj6BkCIUm2HdO_CX1bkLK0AxMRJx1Qvvq9eyE3ojhDrrgU6QndcCMjI3EQ0EFZVuGzKkw2JEa3QygUbtN5O6sGIJxMS6fOjFqAwoLHRzY16kztWtqK3EYQNYD-eH9rt7-cdMiZ_3sxxOBKi8NPKJdlCQ3d8YA6kcdYwK74nEj6SR_19uy6lY_5AMRE6jrWyad2BwjZ74uuXtv5X3JflE5rpANe7tYUTASS-9Dwb9x3w","type":"text"},{"key":"x-one-time-token","value":"741e5c62-758d-4a3f-8ba4-4c2a0e2c0828","type":"text"}],"body":{"mode":"raw","raw":"{\n \"reference\": 100863,\n \"agreementId\": 2,\n \"amount\": 10000,\n \"date\": \"2025-03-30\",\n \"time\": \"01:30\"\n}","options":{"raw":{"language":"json"}}},"url":"https://collection-api.qa.refacil.co/collection/submit-payment","description":"This endpoint handles financial transactions and collections. It processes payments, validates customers and companies, and integrates with a payment processing system. The service includes transaction amount validation, customer verification, and company balance management.
\n⚠️ Only the above agreementIds are currently authorized to use this service.
This endpoint allows you to validate a JWT token by sending an HTTP POST request to {{base_url}}/auth/validate.
\nBase URL:
\nThis endpoint sends an HTTP GET request to {{customer.domain.com}}/ping/ in order to check the availability of the server.
\nFail-fast: detects unavailability before critical operations.
\nSLO-aware: monitor per-client availability and trigger mitigations.
\nProactive ops: enables circuit breakers and routing policies.
\nThe request does not contain a request body.
\nStatus: 200
\nBody: \"pong\"
\nTo integrate with Own Network Collection, all integration endpoint URLs must follow secure domain standards.
\nMust be a fully qualified domain URL, for example: https://api.yourdomain.com/path.
http://, IP-only endpoints, localhost domains, or self-signed development URLs are not accepted in production onboarding.
The domain must be publicly resolvable and reachable from Refacil infrastructure.
\nOnly HTTPS endpoints are accepted.
\nThe domain must present a valid SSL/TLS certificate issued by a trusted CA.
\nThe certificate must be active (not expired), with a complete certificate chain and valid hostname (CN/SAN match).
\nRequests can be rejected during merchant setup or runtime if certificate validation fails.
\nEnforce token-based authentication exactly as documented (Authorization header).
Validate payload schema, data types, and required fields before processing.
\nProtect endpoints against replay and duplicate processing using idempotency controls where applicable.
\nDo not expose secrets, tokens, or sensitive personal data in logs or error messages.
\nApply network hardening controls (rate limiting, allowlisting where possible, and TLS 1.2+ minimum).
\n\n\n","urlObject":{"protocol":"https","path":["ping",""],"host":["{{customer.domain.com}}"],"query":[],"variable":[]}},"response":[{"id":"5ac86e44-03f3-4a69-9def-b20a68f7070c","name":"ping OK","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Token {{generate_token}}","type":"text"}],"url":"https://{{customer.domain.com}}/ping/"},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Date","value":"Fri, 15 Dec 2023 14:50:19 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"6"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"openresty/1.15.8.1"},{"key":"Vary","value":"Accept, Accept-Language, origin"},{"key":"Allow","value":"GET, HEAD, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Language","value":"en"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"same-origin"}],"cookie":[],"responseTime":null,"body":"\"pong\""},{"id":"b87ac126-3fb3-4485-a7fa-835c69c3fe95","name":"ping Unauthorized","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Token {{generate_invalid_token}}","type":"text"}],"url":"https://{{customer.domain.com}}/ping/"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 15 Dec 2023 14:50:19 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"6"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"openresty/1.15.8.1"},{"key":"Vary","value":"Accept, Accept-Language, origin"},{"key":"Allow","value":"GET, HEAD, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Language","value":"en"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"same-origin"}],"cookie":[],"responseTime":null,"body":"{\r\n \"detail\": \"Invalid token.\"\r\n}"}],"_postman_id":"a2ece8f9-2da0-4cef-9485-e73e15fa7223"},{"name":"queryBill","event":[{"listen":"prerequest","script":{"exec":["var moment = require('moment');\r","var ISO_8601_OFFSET = 'YYYY-MM-DDTHH:mm:ss.SSS';\r","var format_date = 'YYYY-MM-DD';\r","var format_time = 'HH:mm:ss';\r","var momentdate = moment().subtract(1, 'days').format(ISO_8601_OFFSET);\r","\r","var date = moment().format(format_date);\r","var time = moment().format(format_time);\r","\r","pm.environment.set(\"date\", date);\r","pm.environment.set(\"time\", time);\r",""],"type":"text/javascript","packages":{}}}],"id":"20a360ac-60fa-4799-b50b-3899be462b96","request":{"method":"POST","header":[{"key":"Authorization","value":"Token {{generate_token}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"codCustomer\": \"1\",\r\n \"reference\": \"52851385\",\r\n \"date\": \"2025-03-16\",\r\n \"time\": \"15:03:04\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://{{customer.domain.com}}/queryBill/","description":"Important: If an endpoint URL does not comply with the secure domain and SSL requirements, merchant enablement and/or notification delivery can fail.
\n
This endpoint allows you to query a bill by sending an HTTP POST request to {{customer.domain.com}}/queryBill/.
Real-time validation: fresh billing info from the originator.
\nStandard error handling: predictable codes/messages simplify UX and support.
\nLower coupling: each client exposes its endpoint; the bridge resolves routing by agreement.
\nObservability: traceability via transactionId from query to payment.
Multiple payment values: support for references with multiple payment options via paymentOrder.
To integrate with Own Network Collection, all integration endpoint URLs must follow secure domain standards.
\nMust be a fully qualified domain URL, for example: https://api.yourdomain.com/path.
http://, IP-only endpoints, localhost domains, or self-signed development URLs are not accepted in production onboarding.
The domain must be publicly resolvable and reachable from Refacil infrastructure.
\nOnly HTTPS endpoints are accepted.
\nThe domain must present a valid SSL/TLS certificate issued by a trusted CA.
\nThe certificate must be active (not expired), with a complete certificate chain and valid hostname (CN/SAN match).
\nRequests can be rejected during merchant setup or runtime if certificate validation fails.
\nEnforce token-based authentication exactly as documented (Authorization header).
Validate payload schema, data types, and required fields before processing.
\nProtect endpoints against replay and duplicate processing using idempotency controls where applicable.
\nDo not expose secrets, tokens, or sensitive personal data in logs or error messages.
\nApply network hardening controls (rate limiting, allowlisting where possible, and TLS 1.2+ minimum).
\n\n\nImportant: If an endpoint URL does not comply with the secure domain and SSL requirements, merchant enablement and/or notification delivery can fail.
\n
When paymentOrder is present in the response, it contains the following structure:
Note: When paymentOrder is provided in the response, it indicates that the reference supports multiple payment concepts. The client should use the items array to present payment options to the user, and then send the selected items in the paymentOrderItems field when submitting the transaction via submitTransaction.
This API endpoint allows you to submit a transaction via an HTTP POST request to {{customer.domain.com}}/submitTransaction/.
\nTransactional idempotency: transactionId avoids double charges on retries/timeouts.
Eventual consistency: queues + webhook confirmations reduce manual reconciliation.
\nOperational scalability: async processing absorbs traffic spikes.
\nMultiple payment items: support for partial payments or multiple concepts within a single transaction via paymentOrderItems.
To integrate with Own Network Collection, all integration endpoint URLs must follow secure domain standards.
\nMust be a fully qualified domain URL, for example: https://api.yourdomain.com/path.
http://, IP-only endpoints, localhost domains, or self-signed development URLs are not accepted in production onboarding.
The domain must be publicly resolvable and reachable from Refacil infrastructure.
\nOnly HTTPS endpoints are accepted.
\nThe domain must present a valid SSL/TLS certificate issued by a trusted CA.
\nThe certificate must be active (not expired), with a complete certificate chain and valid hostname (CN/SAN match).
\nRequests can be rejected during merchant setup or runtime if certificate validation fails.
\nEnforce token-based authentication exactly as documented (Authorization header).
Validate payload schema, data types, and required fields before processing.
\nProtect endpoints against replay and duplicate processing using idempotency controls where applicable.
\nDo not expose secrets, tokens, or sensitive personal data in logs or error messages.
\nApply network hardening controls (rate limiting, allowlisting where possible, and TLS 1.2+ minimum).
\n\n\nImportant: If an endpoint URL does not comply with the secure domain and SSL requirements, merchant enablement and/or notification delivery can fail.
\n
When using paymentOrderItems, each element in the array must have the following structure:
Note: When paymentOrderItems is provided, it allows processing multiple payment concepts or partial payments within a single transaction. The main amount field should match the sum of all amount values in paymentOrderItems.
This API endpoint allows you to submit a transaction via an HTTP POST request to {{customer.domain.com}}/rollbackTransaction/.
\nRisk control: safe, auditable reversal for external failures/inconsistencies.
\nFull traceability: reversal events and contingency log.
\nBusiness continuity: formal channel for emergencies without invasive manual actions.
\nMultiple payment items support: allows rollback of transactions with multiple payment concepts via paymentOrderItems.
To integrate with Own Network Collection, all integration endpoint URLs must follow secure domain standards.
\nMust be a fully qualified domain URL, for example: https://api.yourdomain.com/path.
http://, IP-only endpoints, localhost domains, or self-signed development URLs are not accepted in production onboarding.
The domain must be publicly resolvable and reachable from Refacil infrastructure.
\nOnly HTTPS endpoints are accepted.
\nThe domain must present a valid SSL/TLS certificate issued by a trusted CA.
\nThe certificate must be active (not expired), with a complete certificate chain and valid hostname (CN/SAN match).
\nRequests can be rejected during merchant setup or runtime if certificate validation fails.
\nEnforce token-based authentication exactly as documented (Authorization header).
Validate payload schema, data types, and required fields before processing.
\nProtect endpoints against replay and duplicate processing using idempotency controls where applicable.
\nDo not expose secrets, tokens, or sensitive personal data in logs or error messages.
\nApply network hardening controls (rate limiting, allowlisting where possible, and TLS 1.2+ minimum).
\n\n\nImportant: If an endpoint URL does not comply with the secure domain and SSL requirements, merchant enablement and/or notification delivery can fail.
\n
When using paymentOrderItems, each element in the array must have the following structure:
Note: When paymentOrderItems is provided, it allows rollback of transactions with multiple payment concepts. The main amount field should match the sum of all amount values in paymentOrderItems.
This endpoint allows you to receive transaction notifications processed by the payment system. The merchant must implement this endpoint to receive transaction status updates.
\nPush notifications: eliminates polling, reduces cost and update latency.
\nSecurity: signature/auth validation for trusted origin.
\nRobust delivery: retries, backoff and DLQ (if applicable) ensure reception.
\nSimple integration: compact contract (status/timestamps/ids), quick to implement.
\nMultiple payment items: includes payment order items when transactions involve multiple payment concepts.
\nTo integrate with Own Network Collection, all integration endpoint URLs must follow secure domain standards.
\nMust be a fully qualified domain URL, for example: https://api.yourdomain.com/path.
http://, IP-only endpoints, localhost domains, or self-signed development URLs are not accepted in production onboarding.
The domain must be publicly resolvable and reachable from Refacil infrastructure.
\nOnly HTTPS endpoints are accepted.
\nThe domain must present a valid SSL/TLS certificate issued by a trusted CA.
\nThe certificate must be active (not expired), with a complete certificate chain and valid hostname (CN/SAN match).
\nRequests can be rejected during merchant setup or runtime if certificate validation fails.
\nWebhook validation: this endpoint authenticates incoming notifications using the HMAC-SHA1 signature in the sign field, not by JWT or token-based authentication.
Validate payload schema, data types, and required fields before processing.
\nProtect endpoints against replay and duplicate processing using idempotency controls where applicable.
\nDo not expose secrets, tokens, or sensitive personal data in logs or error messages.
\nApply network hardening controls (rate limiting, allowlisting where possible, and TLS 1.2+ minimum).
\n\n\nImportant: If an endpoint URL does not comply with the secure domain and SSL requirements, merchant enablement and/or notification delivery can fail.
\n
When paymentOrderItems is present in the webhook payload, it indicates that the transaction processed multiple payment concepts. The structure matches the items sent in the submitTransaction request:
Note: When paymentOrderItems is present, the amount field represents the total sum of all items. Verify that the sum of paymentOrderItems[].amount equals the total amount.
The sign field must be validated to ensure message integrity. The signature is generated by concatenating the following fields:
\nlet signature = referenceId-resourceId-amount-updatedAt-HASH_KEY;\nsignature = crypto.createHmac(\"sha1\", HASH_KEY).update(signature).digest(\"hex\");\n\nNote: The HASH_KEY will be shared by us during the integration process to ensure secure communication between systems.
\n","urlObject":{"protocol":"https","path":["webhook",""],"host":["{{customer.domain.com}}"],"query":[],"variable":[]}},"response":[{"id":"166410f1-973b-422d-9e2f-816cd75a3431","name":"webhook OK","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Token {{generate_token}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"realAmount\": 2500,\r\n \"amount\": 2400,\r\n \"cost\": \"100\",\r\n \"referenceId\": \"1769505\",\r\n \"customerReference\": \"REF10000016\",\r\n \"updatedAt\": \"2025-07-31 10:21:57\",\r\n \"status\": 2,\r\n \"sign\": \"0ef1c3c2fa48121ee51f225270194f7fb62e2892\",\r\n \"paymentOrderItems\": [\r\n {\r\n \"id\": 1,\r\n \"description\": \"Factura de servicios\",\r\n \"amount\": 1500\r\n },\r\n {\r\n \"id\": 2,\r\n \"description\": \"Multa de tránsito\",\r\n \"amount\": 900\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://{{customer.domain.com}}/webhook/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 15 Dec 2023 14:46:47 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"openresty/1.15.8.1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Vary","value":"Accept, Accept-Language, origin"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Language","value":"en"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 200,\n \"message\": \"Notification received successfully\",\n \"date\": 1640995200000,\n \"payload\": {\n \"transactionId\": \"1769505\",\n \"status\": \"approved\"\n }\n}"}],"_postman_id":"0bea63c0-6e1f-41b0-9365-13caa90a0076"}],"id":"97a18c77-316d-4730-a1ef-ab531bc81818","description":"Collection of Own Network services. Integrators expose these endpoints so the platform can query bills, submit payments, and receive notifications in a consistent way.
\nTo establish a secure connection with our clients' APIs, we will generate and provide you with an authorization token. This token will allow us to authenticate with the API that our clients build.
\nToken format:
\nAuthorization: Token {generate_token_value}
Example:
\nAuthorization: Token eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9**
All errors must return an HTTP status code in the 4xx or 5xx family (i.e. 400 or above). Do not return 2xx codes when the operation has failed.
\nThere is no single mandatory error schema across all endpoints. One of the following patterns is recommended depending on the endpoint type.
\nReturn a JSON body with at least:
\nstatusCode (number): HTTP status code of the response (must match the HTTP status).message (string): Human-readable message describing the error.errorCode (string, optional): Internal error code for integration/support (e.g. auth.invalid, billing.not_found).queryBill, submitTransaction, rollbackTransaction)For transactional operations, use this structure:
\nmessage (string): Message describing the error.reference (string): Reference associated with the operation.amount (number): Amount (0 in case of error).code (string): Business status code (e.g. 003, 004).user_code (string): User code when applicable.additional_data (array): List of { \"label\", \"value\" } objects with additional information.Some examples only return detail (string) or a combination of message, error, and statusCode. When possible, align these responses with Option A for consistency.
In all cases, the error body must be JSON and must provide enough information for the integrator to identify the failure, correct the data, or decide whether to retry.
\n","event":[{"listen":"prerequest","script":{"type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"97a18c77-316d-4730-a1ef-ab531bc81818"}],"id":"47e30cc8-ac7d-433a-8ee1-98afb7540c70","description":"Base URL:
\nTo start using the Collection API, you must first obtain a Secret ID. This ID is provided manually by the support team: 📩 soportetecnico@refacil.com
\n\n","_postman_id":"47e30cc8-ac7d-433a-8ee1-98afb7540c70"}]}Once issued, the Secret ID must be included in all authentication requests using the header
\nx-secret-id