{"id":3824,"date":"2021-03-25T20:13:50","date_gmt":"2021-03-25T20:13:50","guid":{"rendered":"https:\/\/documents.openpay.mx\/?page_id=3824"},"modified":"2024-07-04T15:30:14","modified_gmt":"2024-07-04T15:30:14","slug":"api","status":"publish","type":"page","link":"https:\/\/documents-mx-dev.opdevhm.com\/en\/api","title":{"rendered":"API"},"content":{"rendered":"<p><a href=\"https:\/\/www.openpay.mx\"><br \/>\n<img fetchpriority=\"high\" decoding=\"async\" src=\"https:\/\/documents.openpay.mx\/wp-content\/uploads\/2022\/02\/openpay-color.png\" sizes=\"(max-width: 508px) 100vw, 508px\" srcset=\"https:\/\/documents.openpay.mx\/wp-content\/uploads\/2022\/02\/openpay-color.png 508w, https:\/\/documents.openpay.mx\/wp-content\/uploads\/2022\/02\/openpay-color-300x76.png 300w, https:\/\/documents.openpay.mx\/wp-content\/uploads\/2022\/02\/openpay-color-16x4.png 16w\" alt=\"\" width=\"508\" height=\"128\" \/> <\/a><\/p>\n<h2 id=\"introducci-n\">Intro<\/h2>\n<p>The Openpay API is designed on <a href=\"http:\/\/es.wikipedia.org\/wiki\/Representational_State_Transfer\">REST<\/a>, therefore you\u2019ll find that URLs are oriented to resources and that HTTP response codes are used to indicate errors in the API.<\/p>\n<p>All the API responses are in <a href=\"http:\/\/www.json.org\/\">JSON<\/a>format, including the errors.<\/p>\n<p>In the case to use the existents Openpay API clients (<a href=\"https:\/\/github.com\/open-pay\/openpay-java\">Java<\/a>, <a href=\"https:\/\/github.com\/open-pay\/openpay-php\">Php<\/a>, <a href=\"https:\/\/github.com\/open-pay\/openpay-dotnet\">C#<\/a>, <a href=\"https:\/\/github.com\/open-pay\/openpay-python\">Python<\/a>, <a href=\"https:\/\/github.com\/open-pay\/openpay-ruby\">Ruby<\/a>, <a href=\"https:\/\/github.com\/open-pay\/openpay-node\">NodeJS<\/a>), the responses are specifically of type defined in the clients and their respective languajes.<\/p>\n<h2 id=\"api-endpoints\">API Endpoints<\/h2>\n<blockquote><p>Available resourcers<\/p><\/blockquote>\n<blockquote><p>a) By Merchant<\/p><\/blockquote>\n<pre><code>\/v1\/{MERCHANT_ID}\/...\r\n\/fees\r\n\/fees\/{FEE_ID}\r\n\/charges\r\n\/charges\/{TRANSACTION_ID}\r\n\/payouts\r\n\/payouts\/{TRANSACTION_ID}\r\n\/cards\r\n\/cards\/{CARD_ID}\r\n\/customers\r\n\/customers\/{CUSTOMER_ID}\r\n\/plans\r\n\/plans\/{PLAN_ID}\r\n\/tokens\r\n\/tokens\/{TOKEN_ID}\r\n<\/code><\/pre>\n<blockquote><p>b) By Customer<\/p><\/blockquote>\n<pre><code>\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/...\r\n\/cards\r\n\/cards\/{CARD_ID}\r\n\/bankaccounts\r\n\/bankaccounts\/{BANKACCOUNT_ID}\r\n\/charges\r\n\/charges\/{TRANSACTION_ID}\r\n\/payouts\r\n\/payouts\/{TRANSACTION_ID}\r\n\/transfers\r\n\/transfers\/{TRANSACTION_ID}\r\n\/subscriptions\r\n\/subscriptions\/{SUBSCRIPTION_ID}\r\n<\/code><\/pre>\n<p>The Openpay REST API has a test environment (sandbox) and a production environment. For integrating your system with Openpay, use the credentials that were generated when you signed up. Once you are ready to move to production environment and your request is approved, new credentials will be generated for accessing the production environment.<\/p>\n<p>The following URIs are the basis of the endpoints for the supported environments:<\/p>\n<ul>\n<li><strong>Testing<\/strong>, URI base:<br \/>\n<code>Production:<\/code><\/li>\n<li><strong>Production<\/strong>, URI base:<br \/>\n<code>https:\/\/api.openpay.mx<\/code><\/li>\n<\/ul>\n<p>A complete endpoint consists of the base URI of the environment, the identifier of the Merchant and the resource.<\/p>\n<p>For example, if we want to create a new customer, the endpoint would be:<\/p>\n<p><code>POST https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers<\/code><\/p>\n<p>In order to create a complete request is necessary to send the right HTTP headers and the information in JSON format.<\/p>\n<h2 id=\"autenticaci-n\">Authentication<\/h2>\n<blockquote><p>Authentication example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/charges \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:\r\nEl par\u00e1metro -u se ocupa para realizar la autenticaci\u00f3n HTTP Basic (al agregar dos puntos despu\u00e9s de la llave privada se previene el uso de contrase\u00f1a)\r\n<\/code><\/pre>\n<blockquote><p>Production<\/p><\/blockquote>\n<pre><code>Solo es necesario usar la URI base https:\/\/api.openpay.mx\r\n<\/code><\/pre>\n<p>Para realizar peticiones a la API de Openpay, es necesario enviar la llave de API (API Key) en todas tus llamadas a nuestros servidores. La llave la puedes obtener desde el <a href=\"https:\/\/sandbox-dashboard.openpay.mx\/\">dashboard<\/a>.<\/p>\n<p>There are 2 types of API keys:<\/p>\n<ul>\n<li><strong>Private.-<\/strong> For calls between servers and full access to all API operations (should never be shared).<\/li>\n<\/ul>\n<ul>\n<li><strong>Public.-<\/strong> should only be used in JavaScript calls. This key is only allowed to create cards or create tokens.<\/li>\n<\/ul>\n<p>For API authentication you must use the <a href=\"http:\/\/es.wikipedia.org\/wiki\/Autenticaci%C3%B3n_de_acceso_b%C3%A1sica\">basic access authentication<\/a>, where the API key is the username. The password is not required and it should be left blank for purposes of simplicity<\/p>\n<h2 id=\"errores\">Errors<\/h2>\n<p>Openpay returns JSON objects in the service responses.<\/p>\n<h2 id=\"objeto-error\">Error Object<\/h2>\n<blockquote><p>Object example<\/p><\/blockquote>\n<pre><code>{\r\n    \"category\" : \"request\",\r\n    \"description\" : \"The customer with id 'm4hqp35pswl02mmc567' does not exist\",\r\n    \"http_code\" : 404,\r\n    \"error_code\" : 1005,\r\n    \"request_id\" : \"1981cdb8-19cb-4bad-8256-e95d58bc035c\",\r\n    \"fraud_rules\": [\r\n        \"Billing &lt;&gt; BIN Country for VISA\/MC\"\r\n    ]\r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>category<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\n<strong>request:<\/strong> It means an error caused by data sent by the customer. For example, an invalid request, an attempt of a transaction without funds or a transfer to an account that does not exist.<strong>internal:<\/strong> It means an error on the Openpay side, this will occur very rarely.<strong>gateway:<\/strong> It means an error during the transaction of funds from one card to the Openpay account or from the to a bank account or card.<\/td>\n<\/tr>\n<tr>\n<td>error_code<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nThis is the Openpay error code.<\/td>\n<\/tr>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nError description.<\/td>\n<\/tr>\n<tr>\n<td>http_code<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nHTTP error code from the response.<\/td>\n<\/tr>\n<tr>\n<td>request_id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nRequest identifier<\/td>\n<\/tr>\n<tr>\n<td>fraud_rules<\/td>\n<td><strong><em>array<\/em><\/strong><br \/>\nArray with antifraud rules broken according to fraud detection rules.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"c-digos-de-error\">Error codes<\/h2>\n<h3 id=\"generales\">General<\/h3>\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>HTTP Error<\/th>\n<th>Cause<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1000<\/td>\n<td>500 Internal Server Error<\/td>\n<td>An error happened in the internal Openpay server.<\/td>\n<\/tr>\n<tr>\n<td>1001<\/td>\n<td>400 Bad Request<\/td>\n<td>The request is not JSON valid format, the fields don\u2019t have the correct format, or the request doesn\u2019t have the required fields.<\/td>\n<\/tr>\n<tr>\n<td>1002<\/td>\n<td>401 Unauthorized<\/td>\n<td>The request is not authenticated or is incorrect.<\/td>\n<\/tr>\n<tr>\n<td>1003<\/td>\n<td>422 Unprocessable Entity<\/td>\n<td>The operation could not be completed because the value of one or more of the parameters is incorrect.<\/td>\n<\/tr>\n<tr>\n<td>1004<\/td>\n<td>503 Service Unavailable<\/td>\n<td>A required service is not available.<\/td>\n<\/tr>\n<tr>\n<td>1005<\/td>\n<td>404 Not Found<\/td>\n<td>A required resource doesn\u2019t exist.<\/td>\n<\/tr>\n<tr>\n<td>1006<\/td>\n<td>409 Conflict<\/td>\n<td>There is already a transaction with the same ID order.<\/td>\n<\/tr>\n<tr>\n<td>1007<\/td>\n<td>402 Payment Required<\/td>\n<td>The funds transfer between the bank account or card and the Openpay account was rejected.<\/td>\n<\/tr>\n<tr>\n<td>1008<\/td>\n<td>423 Locked<\/td>\n<td>One of the required accounts is deactivated.<\/td>\n<\/tr>\n<tr>\n<td>1009<\/td>\n<td>413 Request Entity too large<\/td>\n<td>The request body is too large.<\/td>\n<\/tr>\n<tr>\n<td>1010<\/td>\n<td>403 Forbidden<\/td>\n<td>The public key is being used to make a request that requires the private key, or the private key is being using from Javascript.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"almacenamiento\">Storage<\/h3>\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>HTTP Error<\/th>\n<th>Cause<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2001<\/td>\n<td>409 Conflict<\/td>\n<td>The bank account already exists.<\/td>\n<\/tr>\n<tr>\n<td>2002<\/td>\n<td>409 Conflict<\/td>\n<td>The card with this number is already registered on the customer.<\/td>\n<\/tr>\n<tr>\n<td>2003<\/td>\n<td>409 Conflict<\/td>\n<td>The external_id already exists.<\/td>\n<\/tr>\n<tr>\n<td>2004<\/td>\n<td>422 Unprocessable Entity<\/td>\n<td>The check digit card number is invalid according to the Luhn algorithm.<\/td>\n<\/tr>\n<tr>\n<td>2005<\/td>\n<td>400 Bad Request<\/td>\n<td>The expiration date has expired.<\/td>\n<\/tr>\n<tr>\n<td>2006<\/td>\n<td>400 Bad Request<\/td>\n<td>The CVV2 security code is required.<\/td>\n<\/tr>\n<tr>\n<td>2007<\/td>\n<td>412 Precondition Failed<\/td>\n<td>The card number is only valid in sandbox.<\/td>\n<\/tr>\n<tr>\n<td>2008<\/td>\n<td>412 Precondition Failed<\/td>\n<td>The consulted card is not valid for points.<\/td>\n<\/tr>\n<tr>\n<td>2009<\/td>\n<td>412 Precondition Failed<\/td>\n<td>The card security code (CVV2) is not valid.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"tarjetas\">Cards<\/h3>\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>HTTP Error<\/th>\n<th>Cause<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>3001<\/td>\n<td>402 Payment Required<\/td>\n<td>Card declined.<\/td>\n<\/tr>\n<tr>\n<td>3002<\/td>\n<td>402 Payment Required<\/td>\n<td>Card is expired.<\/td>\n<\/tr>\n<tr>\n<td>3003<\/td>\n<td>402 Payment Required<\/td>\n<td>Card has not enough funds.<\/td>\n<\/tr>\n<tr>\n<td>3004<\/td>\n<td>402 Payment Required<\/td>\n<td>Card has been flagged as stolen.<\/td>\n<\/tr>\n<tr>\n<td>3005<\/td>\n<td>402 Payment Required<\/td>\n<td>The card has been identified as a fraudulent card.<\/td>\n<\/tr>\n<tr>\n<td>3006<\/td>\n<td>412 Precondition Failed<\/td>\n<td>The operation is not allowed for this customer or transaction.<\/td>\n<\/tr>\n<tr>\n<td>3008<\/td>\n<td>412 Precondition Failed<\/td>\n<td>The card is not supported in online transactions.<\/td>\n<\/tr>\n<tr>\n<td>3009<\/td>\n<td>402 Payment Required<\/td>\n<td>Card has been flagged as lost.<\/td>\n<\/tr>\n<tr>\n<td>3010<\/td>\n<td>402 Payment Required<\/td>\n<td>The card has been restricted by the bank.<\/td>\n<\/tr>\n<tr>\n<td>3011<\/td>\n<td>402 Payment Required<\/td>\n<td>The bank has requested to hold this card. Please contact the bank.<\/td>\n<\/tr>\n<tr>\n<td>3012<\/td>\n<td>412 Precondition Failed<\/td>\n<td>Bank authorization is required to make this payment.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"cuentas\">Accounts<\/h3>\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>HTTP Error<\/th>\n<th>Cause<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>4001<\/td>\n<td>412 Preconditon Failed<\/td>\n<td>The Openpay account doesn\u2019t have enough funds.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"cargos\">Charges<\/h2>\n<p>Charges can be made to cards, stores and banks. Each charge is assigned with an unique identifier in the system.<\/p>\n<p>You can do card charges by using a saved card id, using a token or you can send the card information at the time of invocation.<\/p>\n<p><b>Cambios por disposiciones oficiales para la prevenci\u00f3n de fraude E-commerce<\/b><\/p>\n<p>Toda integraci\u00f3n que se realice mediante SDK o peticiones directas al API de Openpay, es de car\u00e1cter obligatorio enviar el header <b>X-Forwarded-For <\/b>donde se deber\u00e1 indicar la IP del dispositivo del cliente. En las pesta\u00f1as de las diferentes tecnolog\u00edas ubicadas del lado derecho se encuentra la definici\u00f3n de c\u00f3mo debe ser enviado.<\/p>\n<p>&nbsp;<\/p>\n<h2 id=\"con-id-de-tarjeta-o-token\">With a card id or token<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/charges\r\nCliente\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/charges\r\n<\/code><\/pre>\n<blockquote><p>Merchant request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/charges \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n   \"source_id\" : \"kqgykn96i7bcs1wwhvgw\",\r\n   \"method\" : \"card\",\r\n   \"amount\" : 100,\r\n   \"currency\" : \"MXN\",\r\n   \"description\" : \"Cargo inicial a mi cuenta\",\r\n   \"order_id\" : \"oid-00051\",\r\n   \"device_session_id\" : \"kR1MiQhz2otdIuUlQkbEyitIqVMiI16f\",\r\n   \"customer\" : {\r\n        \"name\" : \"Juan\",\r\n        \"last_name\" : \"Vazquez Juarez\",\r\n        \"phone_number\" : \"4423456723\",\r\n        \"email\" : \"juan.vazquez@empresa.com.mx\"\r\n   }\r\n}'\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"trzjaozcik8msyqshka4\",\r\n   \"amount\":100.00,\r\n   \"authorization\":\"801585\",\r\n   \"method\":\"card\",\r\n   \"operation_type\":\"in\",\r\n   \"transaction_type\":\"charge\",\r\n   \"card\":{\r\n      \"id\":\"kqgykn96i7bcs1wwhvgw\",\r\n      \"type\":\"debit\",\r\n      \"brand\":\"visa\",\r\n      \"address\":null,\r\n      \"card_number\":\"411111XXXXXX1111\",\r\n      \"holder_name\":\"Juan Perez Ramirez\",\r\n      \"expiration_year\":\"20\",\r\n      \"expiration_month\":\"12\",\r\n      \"allows_charges\":true,\r\n      \"allows_payouts\":true,\r\n      \"creation_date\":\"2014-05-26T11:02:16-05:00\",\r\n      \"bank_name\":\"Banamex\",\r\n      \"bank_code\":\"002\"\r\n   },\r\n   \"status\":\"completed\",\r\n   \"currency\":\"USD\",\r\n   \"exchange_rate\" : {\r\n      \"from\" : \"USD\",\r\n      \"date\" : \"2014-11-21\",\r\n      \"value\" : 13.61,\r\n      \"to\" : \"MXN\"\r\n   },\r\n   \"creation_date\":\"2014-05-26T11:02:45-05:00\",\r\n   \"operation_date\":\"2014-05-26T11:02:45-05:00\",\r\n   \"description\":\"Cargo inicial a mi cuenta\",\r\n   \"error_message\":null,\r\n   \"order_id\":\"oid-00051\"\r\n}\r\n<\/code><\/pre>\n<p>This type of charge requires a saved card or a previously generated token. To save cards read <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-una-tarjeta\">Create a card<\/a> and to use tokens visit the <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-un-nuevo-token\">Creation of tokens<\/a>.<\/p>\n<p>Once you have a saved card or token use the <code>source_id<\/code> property to send the identifier.<\/p>\n<p>The <code>device_session_id<\/code> property must be generated using JavaScript API, see <a href=\"https:\/\/github.com\/open-pay\/openpay-js#fraud-detection-using-device-data\">Fraud detection using device data<\/a>.<\/p>\n<p><strong><em>Customized antifraud system<\/em><\/strong><br \/>\nYou can send extra data to Openpay in order to increase number of variables and get better results in antifraud detection for your transactions.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>method<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nIt must contain the <strong>card<\/strong> value in order to specify the charge will be made from card.<\/td>\n<\/tr>\n<tr>\n<td>source_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nID of the saved card or token id created from where the funds will be withdrawn.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nAmount of charge. Must be an amount greater than zero, with up to two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>cvv2<\/td>\n<td><strong><em>numeric<\/em><\/strong> (length = 3 or 4)<br \/>\nSecurity code as it appears on the back of the card. Usually 3 digits.<br \/>\nIt\u2019s used only charges with <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-una-tarjeta\">Stored Cards<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>currency<\/td>\n<td><strong><em>string<\/em><\/strong> (optional)<br \/>\nType of currency of charge. At the moment only two types of currencies are supported: Mexican Pesos (MXN) and American Dollars (USD).<\/td>\n<\/tr>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 250)<br \/>\nA description associated with the position.<\/td>\n<\/tr>\n<tr>\n<td>order_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nUnique identifier of the position. Must be unique among all transactions.<\/td>\n<\/tr>\n<tr>\n<td>device_session_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 255)<br \/>\nIdentifier of the device generated by the antifraud tool.<\/td>\n<\/tr>\n<tr>\n<td>capture<\/td>\n<td><strong><em>boolean<\/em><\/strong> (opcional, default = true)<br \/>\nIndicates whether the charge is made immediately or not , when the value is false the charge is handled as authorized (or pre-authorization) and the amount is only to be confirmed or canceled in a second call.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-un-nuevo-cliente\">customer<\/a><\/td>\n<td><strong><em>object<\/em><\/strong> (required)<br \/>\nCustomer information who is charged. You can use the same parameters used in the creation of a customer but an account for the customer will not be created.<strong>Note:<\/strong> Este par\u00e1metro solo se puede utilizar creando el cargo a nivel comercioSi desea crear un cliente y llevar un historial de sus cargos consulte como <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-un-nuevo-cliente\">create a customer<\/a> and do the charge at the customer level.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-paymentplan\">payment_plan<\/a><\/td>\n<td><strong><em>object<\/em><\/strong> (optional)<br \/>\nPlan data months without interest is desired as use in the charge. Refer to <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-paymentplan\">PaymentPlan Object<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>metadata<\/td>\n<td><strong><em>list(key, value)<\/em><\/strong> (optional)<br \/>\nField list to send antifraud system, It must be according to <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#reglas-para-creaci\u00f3n-de-campos-personalizados-de-antifraude\">Rules to send custom antifraud fields.<\/a><\/td>\n<\/tr>\n<tr>\n<td>use_card_points<\/td>\n<td><strong><em>string<\/em><\/strong> (optional, default = NONE)<\/p>\n<table>\n<tbody>\n<tr>\n<td><strong>ONLY_POINTS<\/strong><\/td>\n<td>Charge only with points (<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#consulta-de-puntos\">Card points<\/a>)<\/td>\n<\/tr>\n<tr>\n<td><strong>MIXED<\/strong><\/td>\n<td>Charge with points and pesos<\/td>\n<\/tr>\n<tr>\n<td><strong>NONE<\/strong><\/td>\n<td>Charge only with pesos<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The values that indicate points must be used only if the points_card property is true, otherwise an error will occur.<\/td>\n<\/tr>\n<tr>\n<td>send_email<\/td>\n<td><strong><em>boolean<\/em><\/strong> (optional)<br \/>\nUsed in redirect charges. Indicates if is need send a email that redirect to the openpay payment form.<\/td>\n<\/tr>\n<tr>\n<td>redirect_url<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nUsed in redirect charges. It indicates the url to which redirect after a successful transaction in the openpay payment form.<strong>Note:<\/strong> Este par\u00e1metro solo se puede utilizar si se especifica el manejo de 3D Secure.<\/td>\n<\/tr>\n<tr>\n<td>use_3d_secure<\/td>\n<td><strong><em>string<\/em><\/strong> (optional)<br \/>\nUsed to specify if 3D Secure should be used. <code>true<\/code> para manejar 3D Secure.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> with the charge information or with an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"con-redireccionamiento\">With redirect<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/charges\r\nCliente\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/charges\r\n<\/code><\/pre>\n<blockquote><p>Merchant request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/charges \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n   \"method\" : \"card\",\r\n   \"amount\" : 100,\r\n   \"description\" : \"Cargo inicial a mi cuenta\",\r\n   \"order_id\" : \"oid-00051\",\r\n   \"customer\" : {\r\n        \"name\" : \"Juan\",\r\n        \"last_name\" : \"Vazquez Juarez\",\r\n        \"phone_number\" : \"4423456723\",\r\n        \"email\" : \"juan.vazquez@empresa.com.mx\"\r\n   },\r\n   \"confirm\" : \"false\",\r\n   \"send_email\":\"false\",\r\n   \"redirect_url\":\"http:\/\/www.openpay.mx\/index.html\"\r\n}'\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>\r\n{\r\n  \"id\": \"trq7yrthx5vc4gtjdkwg\",\r\n  \"authorization\": null,\r\n  \"method\": \"card\",\r\n  \"operation_type\": \"in\",\r\n  \"transaction_type\": \"charge\",\r\n  \"status\": \"charge_pending\",\r\n  \"conciliated\": false,\r\n  \"creation_date\": \"2016-09-09T18:52:02-05:00\",\r\n  \"operation_date\": \"2016-09-09T18:52:02-05:00\",\r\n  \"description\": \"Cargo desde terminal virtual de 111\",\r\n  \"error_message\": null,\r\n  \"amount\": 100,\r\n  \"currency\": \"MXN\",\r\n  \"payment_method\": {\r\n    \"type\": \"redirect\",\r\n    \"url\": \"https:\/\/sandbox-api.openpay.mx\/v1\/mexzhpxok3houd5lbvz1\/charges\/trq7yrthx5vc4gtjdkwg\/card_capture\"\r\n  },\r\n  \"customer\": {\r\n    \"name\": \"Juan\",\r\n    \"last_name\": \"Vazquez Juarez\",\r\n    \"email\": \"juan.vazquez@empresa.com.mx\",\r\n    \"phone_number\": \"4423456723\",\r\n    \"creation_date\": \"2016-09-09T18:52:02-05:00\",\r\n    \"clabe\": null,\r\n    \"external_id\": null\r\n  }\r\n}\r\n<\/code><\/pre>\n<p>This type of charge don\u2019t requires a saved card or a previously generated token<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>method<\/td>\n<td><strong><em>string<\/em><\/strong> (required in card)<br \/>\nIt must contain the <strong>card<\/strong> value in order to specify the charge will be made from card.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nAmount of charge. Must be an amount greater than zero, with up to two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 250)<br \/>\nA description associated with the position.<\/td>\n<\/tr>\n<tr>\n<td>order_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nUnique identifier of the position. Must be unique among all transactions.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-un-nuevo-cliente\">customer<\/a><\/td>\n<td><strong><em>object<\/em><\/strong> (required)<br \/>\nCustomer information who is charged. You can use the same parameters used in the creation of a customer but an account for the customer will not be created.<strong>Note:<\/strong> Este par\u00e1metro solo se puede utilizar creando el cargo a nivel comercioSi desea crear un cliente y llevar un historial de sus cargos consulte como <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-un-nuevo-cliente\">create a customer<\/a> and do the charge at the customer level.<\/td>\n<\/tr>\n<tr>\n<td>confirm<\/td>\n<td><strong><em>boolean<\/em><\/strong> (required in false)<br \/>\nIndicates whether the charge is made immediately or not , when the value is false the charge is handled as authorized (or pre-authorization) and the amount is only to be confirmed or canceled in a second call. <code>false<\/code> indica que se trata de un cargo con terminal virtual.<\/td>\n<\/tr>\n<tr>\n<td>send_email<\/td>\n<td><strong><em>boolean<\/em><\/strong> (optional)<br \/>\nIndicates if is need send a email that redirect to the openpay payment form.<\/td>\n<\/tr>\n<tr>\n<td>redirect_url<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nIt indicates the url to which redirect after a successful transaction in the openpay payment form.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> with the charge information or with an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"cargo-en-tienda\">Charge via store<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/charges\r\nCliente\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/charges\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/charges \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n   \"method\" : \"store\",\r\n   \"amount\" : 100,\r\n   \"description\" : \"Cargo con tienda\",\r\n   \"order_id\" : \"oid-00053\",\r\n   \"due_date\" : \"2014-05-20T13:45:00\"\r\n} '\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"trnirkiyobo5qfex55ef\",\r\n   \"amount\":100.00,\r\n   \"authorization\":null,\r\n   \"method\":\"store\",\r\n   \"operation_type\":\"in\",\r\n   \"transaction_type\":\"charge\",\r\n   \"status\":\"in_progress\",\r\n   \"currency\":\"MXN\",\r\n   \"creation_date\":\"2014-05-26T13:48:25-05:00\",\r\n   \"operation_date\":\"2014-05-26T13:48:25-05:00\",\r\n   \"due_date\":\"2014-05-28T13:45:00-05:00\",\r\n   \"description\":\"Cargo con tienda\",\r\n   \"error_message\":null,\r\n   \"order_id\":\"oid-00053\",\r\n   \"customer_id\":\"ag4nktpdzebjiye1tlze\",\r\n   \"payment_method\":{\r\n      \"type\":\"store\",\r\n      \"reference\":\"000020TRNIRKIYOBO5QFEX55EF0100009\",\r\n      \"paybin_reference\":\"0101990000001065\",\r\n      \"barcode_url\":\"https:\/\/sandbox-api.openpay.mx\/barcode\/000020TRNIRKIYOBO5QFEX55EF0100009?width=1&amp;height=45&amp;text=false\",\r\n      \"barcode_paybin_url\":\"https:\/\/sandbox-api.openpay.mx\/barcode\/0101990000001065?width=1&amp;height=45&amp;text=false\"\r\n   }\r\n}\r\n<\/code><\/pre>\n<p>For payments at a convenience store you should create a charge type request by indicating <strong>store<\/strong>as method. This will generate a response with a reference number and a URL with a barcode, which you must use to create a receipt so your customer can make the payment in one of the convenience stores. The barcode is Code 128 type.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>method<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nIt must contain the <strong>store<\/strong> value in order to specify you want to pay at store.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nAmount of charge. Must be an amount greater than zero, with up to two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 250)<br \/>\nA description associated with the position.<\/td>\n<\/tr>\n<tr>\n<td>order_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nUnique identifier of the position. Must be unique among all transactions.<\/td>\n<\/tr>\n<tr>\n<td>due_date<\/td>\n<td><strong><em>datetime<\/em><\/strong> (optional)<br \/>\nFecha de vigencia para hacer el pago en la tienda en formato ISO 8601.Ejemplo (UTC): 2014-08-01T00:50:00Z<br \/>\n<strong><em>Note:<\/em><\/strong> Del lado del servidor se cambiara a hora centralEjemplo (Central Time): 2014-08-01T11:51:23-05:00<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-un-nuevo-cliente\">customer<\/a><\/td>\n<td><strong><em>object<\/em><\/strong> (required)<br \/>\nCustomer information who is charged. You can use the same parameters used in the creation of a customer but an account for the customer will not be created.<strong>Note:<\/strong> Este par\u00e1metro solo se puede utilizar creando el cargo a nivel comercioSi desea crear un cliente y llevar un historial de sus cargos consulte como <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-un-nuevo-cliente\">create a customer<\/a> and do the charge at the customer level.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> with the charge information or with an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"cargo-en-banco\">Charge via bank<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/charges\r\nCliente\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/charges\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/charges \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n   \"method\" : \"bank_account\",\r\n   \"amount\" : 100,\r\n   \"description\" : \"Cargo con banco\",\r\n   \"order_id\" : \"oid-00055\",\r\n   \"due_date\"\r\n} '\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"trnzf2xjwpupjfryyj23\",\r\n   \"amount\":100.00,\r\n   \"authorization\":null,\r\n   \"method\":\"bank_account\",\r\n   \"operation_type\":\"in\",\r\n   \"transaction_type\":\"charge\",\r\n   \"status\":\"in_progress\",\r\n   \"currency\":\"MXN\",\r\n   \"creation_date\":\"2014-05-26T13:51:25-05:00\",\r\n   \"operation_date\":\"2014-05-26T13:51:25-05:00\",\r\n   \"description\":\"Cargo con banco\",\r\n   \"error_message\":null,\r\n   \"order_id\":\"oid-00055\",\r\n   \"customer_id\":\"ag4nktpdzebjiye1tlze\",\r\n   \"payment_method\":{\r\n      \"type\":\"bank_transfer\",\r\n      \"agreement\" : \"1411217\",\r\n      \"bank\":\"BBVA Bancomer\",\r\n      \"clabe\":\"012914002014112176\",\r\n      \"name\":\"11030021342311520255\"\r\n   }\r\n}\r\n<\/code><\/pre>\n<p>For a charge via bank you must create a charge type request by indicating <strong>bank_account<\/strong>as method. This will generate a response with a Bancomer CIE agreement number, a CLABE account number and a reference, you have to indicate these data in a receipt so your customer can do the wire transfer via SPEI.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>method<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nIt must contain the <strong>bank_account<\/strong> value to specify the pay will be made with bank transfer.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nAmount of charge. Must be an amount greater than zero, with up to two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 250)<br \/>\nA description associated with the position.<\/td>\n<\/tr>\n<tr>\n<td>order_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nUnique identifier of the position. Must be unique among all transactions.<\/td>\n<\/tr>\n<tr>\n<td>due_date<\/td>\n<td><strong><em>datetime<\/em><\/strong> (optional)<br \/>\nFecha de vigencia para hacer el cargo a banco en formato ISO 8601.Ejemplo (UTC): 2014-08-01T00:50:00Z<br \/>\n<strong><em>Note:<\/em><\/strong> Del lado del servidor se cambiara a hora centralEjemplo (Central Time): 2014-08-01T11:51:23-05:00<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-un-nuevo-cliente\">customer<\/a><\/td>\n<td><strong><em>object<\/em><\/strong> (optional)<br \/>\nCustomer information who is charged. You can use the same parameters used in the creation of a customer but an account for the customer will not be created.<strong>Note:<\/strong> Este par\u00e1metro solo se puede utilizar creando el cargo a nivel comercioSi desea crear un cliente y llevar un historial de sus cargos consulte como <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-un-nuevo-cliente\">create a customer<\/a> and do the charge at the customer level.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> with the charge information or with an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"cargo-en-alipay\">With Alipay<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/charges\r\nCliente\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/charges\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/charges \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n   \"description\": \"Cargo Alipay\",\r\n   \"amount\": \"2000.00\",\r\n   \"method\": \"alipay\",\r\n   \"redirect_url\" : \"http:\/\/www.example.com\/myRedirectUrl\"\r\n} '\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n    \"id\": \"truq1dwjz0kmssvpbrlj\",\r\n    \"authorization\": null,\r\n    \"operation_type\": \"in\",\r\n    \"method\": \"alipay\",\r\n    \"transaction_type\": \"charge\",\r\n    \"status\": \"charge_pending\",\r\n    \"conciliated\": false,\r\n    \"creation_date\": \"2018-06-14T12:42:11-05:00\",\r\n    \"operation_date\": \"2018-06-14T12:42:11-05:00\",\r\n    \"description\": \"Cargo Alipay\",\r\n    \"error_message\": null,\r\n    \"order_id\": null,\r\n    \"due_date\": \"2018-06-15T12:42:11-05:00\",\r\n    \"payment_method\": {\r\n        \"type\": \"redirect\",\r\n        \"url\": \"https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/charges\/truq1dwjo0kmssvqbrlj\/redirect\/\"\r\n    },\r\n    \"amount\": 2000,\r\n    \"currency\": \"MXN\",\r\n    \"fee\": {\r\n        \"amount\": 2.00  ,\r\n        \"tax\": 0,\r\n        \"currency\": \"MXN\"\r\n    }\r\n}\r\n<\/code><\/pre>\n<p>To start a transaction using Alipay you should create a charge type request by indicating <strong>alipay<\/strong>as method. This will generate a response with an URL which will redirect the customer to the Alipay website where they can then enter their account details, or scan the QR Code in their mobile app.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>method<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nIt must contain the <strong>alipay<\/strong> value in order to specify you want the customer to pay using Alipay.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nAmount of charge. Must be an amount greater than zero, with up to two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 250)<br \/>\nA description associated with the position.<\/td>\n<\/tr>\n<tr>\n<td>order_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nUnique identifier of the position. Must be unique among all transactions.<\/td>\n<\/tr>\n<tr>\n<td>due_date<\/td>\n<td><strong><em>datetime<\/em><\/strong> (optional)<br \/>\nFecha de vigencia para hacer el pago en Alipay en formato ISO 8601. El usuario podr\u00eda tener hasta 15 minutos adicionales despu\u00e9s de esta fecha despu\u00e9s de iniciar su sesi\u00f3n para hacer su pago.Ejemplo (UTC): 2014-08-01T00:50:00Z<br \/>\n<strong><em>Note:<\/em><\/strong> Del lado del servidor se cambiara a hora centralEjemplo (Central Time): 2014-08-01T11:51:23-05:00<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-un-nuevo-cliente\">customer<\/a><\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nCustomer information who is charged. You can use the same parameters used in the creation of a customer but an account for the customer will not be created.<strong>Note:<\/strong> Este par\u00e1metro solo se puede utilizar creando el cargo a nivel comercioSi desea crear un cliente y llevar un historial de sus cargos consulte como <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-un-nuevo-cliente\">create a customer<\/a> and do the charge at the customer level.<\/td>\n<\/tr>\n<tr>\n<td>redirect_url<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nIt indicates the url to which redirect after a successful transaction in the openpay payment form, when a request is receiven in this url, merchant must get id attribute to request for the transaction final result.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> with the charge information or with an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"cargo-con-ivr\">Charge with IVR<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/charges\r\nCliente\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/charges\r\n<\/code><\/pre>\n<blockquote><p>Merchant request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/charges \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n   \"method\" : \"card\",\r\n   \"confirm\": \"ivr\",\r\n   \"amount\" : 100,\r\n   \"currency\" : \"MXN\",\r\n   \"description\" : \"Cargo IVR\",\r\n   \"order_id\" : \"oid-00051\",\r\n   \"customer\" : {\r\n        \"name\" : \"Juan\",\r\n        \"last_name\" : \"Vazquez Juarez\",\r\n        \"phone_number\" : \"4423456723\",\r\n        \"email\" : \"juan.vazquez@empresa.com.mx\"\r\n   }\r\n}'\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n    \"id\": \"tranxr78lb4i58xaliu2\",\r\n    \"authorization\": null,\r\n    \"operation_type\": \"in\",\r\n    \"transaction_type\": \"charge\",\r\n    \"status\": \"charge_pending\",\r\n    \"conciliated\": false,\r\n    \"creation_date\": \"2020-10-16T12:22:25-05:00\",\r\n    \"operation_date\": \"2020-10-16T12:22:25-05:00\",\r\n    \"description\": \"Cargo IVR\",\r\n    \"error_message\": null,\r\n    \"order_id\": \"ord-323\",\r\n    \"due_date\": \"2020-10-17T00:59:59-05:00\",\r\n    \"payment_method\": {\r\n        \"type\": \"ivr\",\r\n        \"phone_number\": \"525588969143\",\r\n        \"ivr_key\": 676105,\r\n        \"attempts\": 0\r\n    },\r\n    \"amount\": 100.00,\r\n    \"currency\": \"MXN\",\r\n    \"customer\": {\r\n        \"name\": \"JUAN\",\r\n        \"last_name\": \"PEREZ\",\r\n        \"email\": \"juan.urbina@hotmail.com\",\r\n        \"phone_number\": \"45155352828\",\r\n        \"address\": null,\r\n        \"creation_date\": \"2020-10-16T12:22:25-05:00\",\r\n        \"external_id\": null,\r\n        \"clabe\": null\r\n    },\r\n    \"method\": \"card\"\r\n}\r\n<\/code><\/pre>\n<p><strong><em>Customized antifraud system<\/em><\/strong><br \/>\nYou can send extra data to Openpay in order to increase number of variables and get better results in antifraud detection for your transactions.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>method<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nIt must contain the <strong>card<\/strong> value in order to specify the charge will be made from card.<\/td>\n<\/tr>\n<tr>\n<td>confirm<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nIt must contain the <strong>ivr<\/strong> value in order to specify the charge will be confirm from IVR.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nAmount of charge. Must be an amount greater than zero, with up to two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>currency<\/td>\n<td><strong><em>string<\/em><\/strong> (optional)<br \/>\nType of currency of charge. At the moment only two types of currencies are supported: Mexican Pesos (MXN) and American Dollars (USD).<\/td>\n<\/tr>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 250)<br \/>\nA description associated with the position.<\/td>\n<\/tr>\n<tr>\n<td>order_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nUnique identifier of the position. Must be unique among all transactions.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-un-nuevo-cliente\">customer<\/a><\/td>\n<td><strong><em>object<\/em><\/strong> (required)<br \/>\nCustomer information who is charged. You can use the same parameters used in the creation of a customer but an account for the customer will not be created.<strong>Note:<\/strong> Este par\u00e1metro solo se puede utilizar creando el cargo a nivel comercioSi desea crear un cliente y llevar un historial de sus cargos consulte como <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-un-nuevo-cliente\">create a customer<\/a> and do the charge at the customer level.<\/td>\n<\/tr>\n<tr>\n<td>metadata<\/td>\n<td><strong><em>list(key, value)<\/em><\/strong> (optional)<br \/>\nField list to send antifraud system, It must be according to <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#reglas-para-creaci\u00f3n-de-campos-personalizados-de-antifraude\">Rules to send custom antifraud fields.<\/a><\/td>\n<\/tr>\n<tr>\n<td>send_email<\/td>\n<td><strong><em>boolean<\/em><\/strong> (optional)<br \/>\nUsed in redirect charges. Indicates if is need send a email that redirect to the openpay payment form.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> with the charge information or with an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"confirmar-un-cargo\">Confirming a charge<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/charges\/{TRANSACTION_ID}\/capture\r\nCliente\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/charges\/{TRANSACTION_ID}\/capture\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/charges\/tryqihxac3msedn4yxed\/capture \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n    \"amount\" : 100.00\r\n} '\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"tryqihxac3msedn4yxed\",\r\n   \"amount\":100.00,\r\n   \"authorization\":\"801585\",\r\n   \"method\":\"card\",\r\n   \"operation_type\":\"in\",\r\n   \"transaction_type\":\"charge\",\r\n   \"card\":{\r\n      \"type\":\"debit\",\r\n      \"brand\":\"visa\",\r\n      \"address\":null,\r\n      \"card_number\":\"411111XXXXXX1111\",\r\n      \"holder_name\":\"Juan Perez Ramirez\",\r\n      \"expiration_year\":\"20\",\r\n      \"expiration_month\":\"12\",\r\n      \"allows_charges\":true,\r\n      \"allows_payouts\":true,\r\n      \"bank_name\":\"Banamex\",\r\n      \"bank_code\":\"002\"\r\n   },\r\n   \"status\":\"completed\",\r\n   \"currency\":\"MXN\",\r\n   \"creation_date\":\"2014-05-26T14:00:17-05:00\",\r\n   \"operation_date\":\"2014-05-26T14:00:17-05:00\",\r\n   \"description\":\"Cargo inicial a mi cuenta\",\r\n   \"error_message\":null,\r\n   \"order_id\":null,\r\n   \"customer_id\":\"ag4nktpdzebjiye1tlze\"\r\n}\r\n<\/code><\/pre>\n<p>Confirm a charge created with the <code>capture = \"false\"<\/code>property, this method is the second part of the <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#con-id-de-tarjeta-o-token\">create a charge with a card (id or token)<\/a> and it can confirm the amount captured on the first call or a lesser amount.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (optional)<br \/>\nAmount to confirm. It can be less than or equal to the amount given with up to two decimal digits<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> with the charge information or with an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"devolver-un-cargo\">Refunding a charge<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/charges\/{TRANSACTION_ID}\/refund\r\nCliente\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/charges\/{TRANSACTION_ID}\/refund\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/charges\/tr6cxbcefzatd10guvvw\/refund \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n   \"description\" : \"devoluci\u00f3n\",\r\n   \"amount\" : 100.00\r\n} '\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"tr6cxbcefzatd10guvvw\",\r\n   \"amount\":100.00,\r\n   \"authorization\":\"801585\",\r\n   \"method\":\"card\",\r\n   \"operation_type\":\"in\",\r\n   \"transaction_type\":\"charge\",\r\n   \"card\":{\r\n      \"type\":\"debit\",\r\n      \"brand\":\"visa\",\r\n      \"address\":null,\r\n      \"card_number\":\"411111XXXXXX1111\",\r\n      \"holder_name\":\"Juan Perez Ramirez\",\r\n      \"expiration_year\":\"20\",\r\n      \"expiration_month\":\"12\",\r\n      \"allows_charges\":true,\r\n      \"allows_payouts\":true,\r\n      \"bank_name\":\"Banamex\",\r\n      \"bank_code\":\"002\"\r\n   },\r\n   \"status\":\"completed\",\r\n   \"refund\":{\r\n      \"id\":\"trcbsmjkroqmjobxqhpb\",\r\n      \"amount\":100.00,\r\n      \"authorization\":\"801585\",\r\n      \"method\":\"card\",\r\n      \"operation_type\":\"out\",\r\n      \"transaction_type\":\"refund\",\r\n      \"status\":\"completed\",\r\n      \"currency\":\"MXN\",\r\n      \"creation_date\":\"2014-05-26T13:56:21-05:00\",\r\n      \"operation_date\":\"2014-05-26T13:56:21-05:00\",\r\n      \"description\":\"devolucion\",\r\n      \"error_message\":null,\r\n      \"order_id\":null,\r\n      \"customer_id\":\"ag4nktpdzebjiye1tlze\"\r\n   },\r\n   \"currency\":\"MXN\",\r\n   \"creation_date\":\"2014-05-26T11:56:25-05:00\",\r\n   \"operation_date\":\"2014-05-26T11:56:25-05:00\",\r\n   \"description\":\"Cargo inicial a mi cuenta\",\r\n   \"error_message\":null,\r\n   \"order_id\":\"oid-00052\",\r\n   \"customer_id\":\"ag4nktpdzebjiye1tlze\"\r\n}\r\n<\/code><\/pre>\n<p>You can use this method if you want to make a charge refund to a card. The amount to be returned will be the total charge or a lower amount. Note that the refund may be delayed in the statement of your customer for 1-3 business days.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong> (optional, length = 250)<br \/>\nText to describe the refund reason.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (optional)<br \/>\nAmount to refund. Must be an amount greater than zero and lesser or equal than the original amount, with up to two decimal digits.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> with the charge information or with an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"obtener-un-cargo\">Obtener un cargo<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/charges\/{TRANSACTION_ID}\r\nComercio\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/charges\/{TRANSACTION_ID}\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/charges\/tr6cxbcefzatd10guvvw \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"tr6cxbcefzatd10guvvw\",\r\n   \"amount\":100.00,\r\n   \"authorization\":\"801585\",\r\n   \"method\":\"card\",\r\n   \"operation_type\":\"in\",\r\n   \"transaction_type\":\"charge\",\r\n   \"card\":{\r\n      \"type\":\"debit\",\r\n      \"brand\":\"visa\",\r\n      \"address\":null,\r\n      \"card_number\":\"411111XXXXXX1111\",\r\n      \"holder_name\":\"Juan Perez Ramirez\",\r\n      \"expiration_year\":\"20\",\r\n      \"expiration_month\":\"12\",\r\n      \"allows_charges\":true,\r\n      \"allows_payouts\":true,\r\n      \"bank_name\":\"Banamex\",\r\n      \"bank_code\":\"002\"\r\n   },\r\n   \"status\":\"completed\",\r\n   \"refund\":{\r\n      \"id\":\"trcbsmjkroqmjobxqhpb\",\r\n      \"amount\":100.00,\r\n      \"authorization\":\"801585\",\r\n      \"method\":\"card\",\r\n      \"operation_type\":\"out\",\r\n      \"transaction_type\":\"refund\",\r\n      \"status\":\"completed\",\r\n      \"currency\":\"MXN\",\r\n      \"creation_date\":\"2014-05-26T13:56:21-05:00\",\r\n      \"operation_date\":\"2014-05-26T13:56:21-05:00\",\r\n      \"description\":\"devolucion\",\r\n      \"error_message\":null,\r\n      \"order_id\":null,\r\n      \"customer_id\":\"ag4nktpdzebjiye1tlze\"\r\n   },\r\n   \"currency\":\"MXN\",\r\n   \"creation_date\":\"2014-05-26T11:56:25-05:00\",\r\n   \"operation_date\":\"2014-05-26T11:56:25-05:00\",\r\n   \"description\":\"Cargo inicial a mi cuenta\",\r\n   \"error_message\":null,\r\n   \"order_id\":\"oid-00052\",\r\n   \"customer_id\":\"ag4nktpdzebjiye1tlze\"\r\n}\r\n<\/code><\/pre>\n<p>Returns a transaction object with the charge information or with an error response.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>transaction_id<\/td>\n<td><em><strong>string<\/strong><\/em> (required, length = 45)<br \/>\nCharge Id.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> with the charge information or with an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"listado-de-cargos\">List of charges<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/charges\r\nComercio\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/charges\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl -g \"https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/charges?creation[gte]=2013-11-01&amp;limit=2\" \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:  \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>[\r\n   {\r\n      \"id\":\"tryqihxac3msedn4yxed\",\r\n      \"amount\":100.00,\r\n      \"authorization\":\"801585\",\r\n      \"method\":\"card\",\r\n      \"operation_type\":\"in\",\r\n      \"transaction_type\":\"charge\",\r\n      \"card\":{\r\n         \"type\":\"debit\",\r\n         \"brand\":\"visa\",\r\n         \"address\":null,\r\n         \"card_number\":\"411111XXXXXX1111\",\r\n         \"holder_name\":\"Juan Perez Ramirez\",\r\n         \"expiration_year\":\"20\",\r\n         \"expiration_month\":\"12\",\r\n         \"allows_charges\":true,\r\n         \"allows_payouts\":true,\r\n         \"bank_name\":\"Banamex\",\r\n         \"bank_code\":\"002\"\r\n      },\r\n      \"status\":\"completed\",\r\n      \"currency\":\"MXN\",\r\n      \"creation_date\":\"2014-05-26T14:00:17-05:00\",\r\n      \"operation_date\":\"2014-05-26T14:00:17-05:00\",\r\n      \"description\":\"Cargo inicial a mi cuenta\",\r\n      \"error_message\":null,\r\n      \"order_id\":null,\r\n      \"customer_id\":\"ag4nktpdzebjiye1tlze\"\r\n   },\r\n   {\r\n      \"id\":\"trnzf2xjwpupjfryyj23\",\r\n      \"amount\":100.00,\r\n      \"authorization\":null,\r\n      \"method\":\"bank_account\",\r\n      \"operation_type\":\"in\",\r\n      \"transaction_type\":\"charge\",\r\n      \"status\":\"in_progress\",\r\n      \"currency\":\"MXN\",\r\n      \"creation_date\":\"2014-05-26T13:51:25-05:00\",\r\n      \"operation_date\":\"2014-05-26T13:51:25-05:00\",\r\n      \"description\":\"Cargo con banco\",\r\n      \"error_message\":null,\r\n      \"order_id\":\"oid-00055\",\r\n      \"customer_id\":\"ag4nktpdzebjiye1tlze\",\r\n      \"payment_method\":{\r\n         \"type\":\"bank_transfer\",\r\n         \"agreement\" : \"1411217\",\r\n         \"bank\":\"BBVA Bancomer\",\r\n         \"clabe\":\"012914002014112176\",\r\n         \"name\":\"11030021342311520255\"\r\n      }\r\n   }\r\n]\r\n<\/code><\/pre>\n<p>Gets a list of the charges made by Merchant or customer.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<p>You can search using the following parameters as filters.<\/p>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>order_id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nUnique order id generated by the merchant and associated to the transaction by the order_id field of the charge request.<\/td>\n<\/tr>\n<tr>\n<td>creation<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nSame as creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[gte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nAfter the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[lte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nBefore the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>offset<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of records to skip at the beginning, default 0.<\/td>\n<\/tr>\n<tr>\n<td>limit<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of required records, default 10.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nSame as the amount.<\/td>\n<\/tr>\n<tr>\n<td>amount[gte]<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nGreater than or equal to the amount.<\/td>\n<\/tr>\n<tr>\n<td>amount[lte]<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nLess than or equal to the amount.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transaction-status\">status<\/a><\/td>\n<td><strong><em>TransactionStatus<\/em><\/strong><br \/>\nEstado de la transacci\u00f3n (IN_PROGRESS,COMPLETED,REFUNDED,CHARGEBACK_PENDING,CHARGEBACK_ACCEPTED,CHARGEBACK_ADJUSTMENT,CHARGE_PENDING,CANCELLED,FAILED).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns an array of <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction objects<\/a> charges in descending order by creation date.<\/p>\n<h2 id=\"pagos-o-retiros\">Payouts or withdrawals<\/h2>\n<p>A payout is the transaction that allows to extract funds from a Openpay account and send the funds to a bank account. Payouts can be made from the accounts of the customers or from the Merchant account.<\/p>\n<h2 id=\"pago-a-id-registrado\">Payout to a registered id<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/payouts\r\nCliente\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/payouts\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/payouts \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n    \"method\": \"bank_account\",\r\n    \"destination_id\": \"b3d54sd3mdjf75udjfvoc\",\r\n    \"amount\": 10.50,\r\n    \"description\": \"Retiro de saldo semanal\",\r\n    \"order_id\": \"oid-00021\"\r\n}' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"amount\":10.5,\r\n   \"authorization\":null,\r\n   \"method\":\"bank_account\",\r\n   \"currency\":\"MXN\",\r\n   \"operation_type\":\"out\",\r\n   \"transaction_type\":\"payout\",\r\n   \"bank_account\":{\r\n      \"id\":\"b3d54sd3mdjf75udjfvoc\",\r\n      \"clabe\":\"012XXXXXXXXXX24616\",\r\n      \"bank_code\":\"012\",\r\n      \"bank_name\":\"BANCOMER\",\r\n      \"alias\":null,\r\n      \"holder_name\":\"Mi empresa\"\r\n   },\r\n   \"status\":\"in_progress\",\r\n   \"id\":\"tm50pl40gf6awvalw1ei\",\r\n   \"creation_date\":\"2013-11-15T13:42:00-06:00\",\r\n   \"description\":\"Retiro de saldo semanal\",\r\n   \"error_message\":null,\r\n   \"order_id\":\"oid-00021\",\r\n   \"customer_id\":\"aayr5jjb1fln44yautef\"\r\n}\r\n<\/code><\/pre>\n<p>Sends a payout to a previously registered bank account. Refer to <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-una-cuenta-bancaria\">create a bank account<\/a><\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>method<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nIt must contain the <strong>bank_account<\/strong>.<\/td>\n<\/tr>\n<tr>\n<td>destination_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nID of the registered bank account.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nAmount of charge. Must be an amount greater than zero, with up to two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 250)<br \/>\nA description associated with the position.<\/td>\n<\/tr>\n<tr>\n<td>order_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nUnique identifier of the position. Must be unique among all transactions.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> with the payout information or with an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"pago-a-cuenta-bancaria\">Payment to a bank account<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/payouts\r\nCliente\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/payouts\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/asynwirguzkgq2bizogo\/payouts \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n   \"method\":\"bank_account\",\r\n   \"bank_account\":{\r\n      \"clabe\":\"012298026516924616\",\r\n      \"holder_name\":\"Mi empresa\"\r\n   },\r\n   \"amount\":100.00,\r\n   \"description\":\"Retiro de saldo semanal\",\r\n   \"order_id\":\"oid-1110011\"\r\n}' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"tr4f2atubqchinw71vfs\",\r\n   \"amount\":10.50,\r\n   \"authorization\":null,\r\n   \"method\":\"bank_account\",\r\n   \"operation_type\":\"out\",\r\n   \"transaction_type\":\"payout\",\r\n   \"status\":\"in_progress\",\r\n   \"currency\":\"MXN\",\r\n   \"creation_date\":\"2014-05-26T17:23:03-05:00\",\r\n   \"operation_date\":\"2014-05-26T17:23:03-05:00\",\r\n   \"description\":\"Retiro de saldo semanal\",\r\n   \"error_message\":null,\r\n   \"order_id\":\"oid-1110011\",\r\n   \"bank_account\":{\r\n      \"clabe\":\"012XXXXXXXXXX24616\",\r\n      \"bank_code\":\"012\",\r\n      \"bank_name\":\"BANCOMER\",\r\n      \"alias\":null,\r\n      \"holder_name\":\"Mi empresa\"\r\n   },\r\n   \"customer_id\":\"asynwirguzkgq2bizogo\"\r\n}\r\n<\/code><\/pre>\n<p>Sends a payment to a bank account.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>method<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nIt must contain the <strong>bank_account<\/strong>.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-cuenta-bancaria\">bank_account<\/a><\/td>\n<td><strong><em>object<\/em><\/strong> (required)<br \/>\nData of the bank account where the funds will be sent.<strong>clabe<\/strong>.- CLABE account number where the funds will be sent.<br \/>\n<strong>holder_name<\/strong>.- Name of the account owner .<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nAmount of charge. Must be an amount greater than zero, with up to two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 250)<br \/>\nA description associated with the position.<\/td>\n<\/tr>\n<tr>\n<td>order_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nUnique identifier of the position. Must be unique among all transactions.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> with the payout information or with an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"obtener-un-pago\">Get a payout<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/payouts\/{TRANSACTION_ID}\r\nComercio\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/payouts\/{TRANSACTION_ID}\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/asynwirguzkgq2bizogo\/payouts\/trwpxhrgfeub9eqdyvqz \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"trwpxhrgfeub9eqdyvqz\",\r\n   \"amount\":10.50,\r\n   \"authorization\":\"TRWPXHRGFEUB9EQDYVQZ\",\r\n   \"method\":\"bank_account\",\r\n   \"operation_type\":\"out\",\r\n   \"transaction_type\":\"payout\",\r\n   \"bank_account\":{\r\n      \"clabe\":\"012XXXXXXXXXX24616\",\r\n      \"bank_code\":\"012\",\r\n      \"bank_name\":\"BANCOMER\",\r\n      \"alias\":null,\r\n      \"holder_name\":\"Mi empresa\"\r\n   },\r\n   \"status\":\"completed\",\r\n   \"currency\":\"MXN\",\r\n   \"creation_date\":\"2014-05-26T17:04:26-05:00\",\r\n   \"operation_date\":\"2014-05-26T17:06:28-05:00\",\r\n   \"description\":\"Retiro de saldo semanal\",\r\n   \"error_message\":null,\r\n   \"order_id\":\"oid-00021\",\r\n   \"customer_id\":\"asynwirguzkgq2bizogo\"\r\n}\r\n<\/code><\/pre>\n<p>Returns de information of the payout. You must know the payout id.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>transaction_id<\/td>\n<td><em><strong>string<\/strong><\/em> (required, length = 45)<br \/>\nId of the payout you want to get.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> with the payout information or with an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"cancelar-un-pago\">Cancel a payout<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nDELETE https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/payouts\/{TRANSACTION_ID}\r\nComercio\r\nDELETE https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/payouts\/{TRANSACTION_ID}\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl -X DELETE https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/asynwirguzkgq2bizogo\/payouts\/trozeipf364jqrsbt3ej \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"trozeipf364jqrsbt3ej\",\r\n   \"amount\":10.50,\r\n   \"authorization\":\"TROZEIPF364JQRSBT3EJ\",\r\n   \"method\":\"bank_account\",\r\n   \"operation_type\":\"out\",\r\n   \"transaction_type\":\"payout\",\r\n   \"bank_account\":{\r\n      \"clabe\":\"012XXXXXXXXXX24616\",\r\n      \"bank_code\":\"012\",\r\n      \"bank_name\":\"BANCOMER\",\r\n      \"alias\":null,\r\n      \"holder_name\":\"Mi empresa\"\r\n   },\r\n   \"status\":\"cancelled\",\r\n   \"currency\":\"MXN\",\r\n   \"creation_date\":\"2014-05-26T17:04:26-05:00\",\r\n   \"operation_date\":\"2014-05-26T17:06:28-05:00\",\r\n   \"description\":\"Retiro de saldo semanal\",\r\n   \"error_message\":null,\r\n   \"order_id\":\"oid-00021\",\r\n   \"customer_id\":\"asynwirguzkgq2bizogo\"\r\n}\r\n<\/code><\/pre>\n<p>Cancels a payout in in_progress status, it means not yet completed. You must know the payout id.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>transaction_id<\/td>\n<td><em><strong>string<\/strong><\/em> (required, length = 45)<br \/>\nPayout Id you want to cancel.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> with the cancelled payout or with an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"listado-de-pagos\">List of payouts<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/payouts\r\nComercio\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/payouts\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl -g \"https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/asynwirguzkgq2bizogo\/payouts?creation[gte]=2013-11-01&amp;limit=2&amp;payout_type=AUTOMATIC\" \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>[\r\n   {\r\n      \"id\":\"tr4f2atubqchinw71vfs\",\r\n      \"amount\":10.50,\r\n      \"authorization\":\"TR4F2ATUBQCHINW71VFS\",\r\n      \"method\":\"bank_account\",\r\n      \"operation_type\":\"out\",\r\n      \"transaction_type\":\"payout\",\r\n      \"status\":\"completed\",\r\n      \"currency\":\"MXN\",\r\n      \"creation_date\":\"2014-05-26T17:23:03-05:00\",\r\n      \"operation_date\":\"2014-05-26T17:26:27-05:00\",\r\n      \"description\":\"Retiro de saldo semanal\",\r\n      \"error_message\":null,\r\n      \"order_id\":\"oid-1110011\",\r\n      \"bank_account\":{\r\n         \"clabe\":\"012XXXXXXXXXX24616\",\r\n         \"bank_code\":\"012\",\r\n         \"bank_name\":\"BANCOMER\",\r\n         \"alias\":null,\r\n         \"holder_name\":\"Mi empresa\"\r\n      },\r\n      \"customer_id\":\"asynwirguzkgq2bizogo\"\r\n   },\r\n   {\r\n      \"id\":\"trwpxhrgfeub9eqdyvqz\",\r\n      \"amount\":10.50,\r\n      \"authorization\":\"TRWPXHRGFEUB9EQDYVQZ\",\r\n      \"method\":\"bank_account\",\r\n      \"operation_type\":\"out\",\r\n      \"transaction_type\":\"payout\",\r\n      \"bank_account\":{\r\n         \"clabe\":\"012XXXXXXXXXX24616\",\r\n         \"bank_code\":\"012\",\r\n         \"bank_name\":\"BANCOMER\",\r\n         \"alias\":null,\r\n         \"holder_name\":\"Mi empresa\"\r\n      },\r\n      \"status\":\"completed\",\r\n      \"currency\":\"MXN\",\r\n      \"creation_date\":\"2014-05-26T17:04:26-05:00\",\r\n      \"operation_date\":\"2014-05-26T17:06:28-05:00\",\r\n      \"description\":\"Retiro de saldo semanal\",\r\n      \"error_message\":null,\r\n      \"order_id\":\"oid-00021\",\r\n      \"customer_id\":\"asynwirguzkgq2bizogo\"\r\n   }\r\n]\r\n<\/code><\/pre>\n<p>Gets a list of payouts made at Merchant or customer level.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<p>You can search using the following parameters as filters.<\/p>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>creation<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nSame as creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[gte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nAfter the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[lte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nBefore the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>offset<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of records to skip at the beginning, default 0.<\/td>\n<\/tr>\n<tr>\n<td>limit<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of required records, default 10.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nSame as the amount.<\/td>\n<\/tr>\n<tr>\n<td>amount[gte]<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nGreater than or equal to the amount.<\/td>\n<\/tr>\n<tr>\n<td>amount[lte]<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nLess than or equal to the amount.<\/td>\n<\/tr>\n<tr>\n<td>payout_type<\/td>\n<td><strong><em>string (opcional, ALL, AUTOMATIC o MANUAL)<\/em><\/strong><br \/>\nPayout type used to filter the transactions<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a list of <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction objects<\/a> payouts in descending order by creation date.<\/p>\n<h2 id=\"resumen-de-pagos\">Summary Payouts<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/reports\/payout\/{TRANSACTION_ID}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/reports\/payout\/trwpxhrgfeub9eqdyvqz \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n  \"in\": 2700,\r\n  \"out\": 2400,\r\n  \"charged_adjustments\": 0,\r\n  \"refunded_adjustments\": 0\r\n}\r\n<\/code><\/pre>\n<p>Return the summary of the payout. You must know the payout id.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>transaction_id<\/td>\n<td><em><strong>string<\/strong><\/em> (required, length = 45)<br \/>\nId of the payout you want to get.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-resumen-de-pagos\">summary payouts object<\/a> with the summary of the payout or a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"objeto-resumen-de-pagos\">Summary Payout Object<\/h2>\n<blockquote><p>Object example<\/p><\/blockquote>\n<pre><code>{\r\n   \"in\":2700,\r\n   \"out\":2400,\r\n   \"charged_adjustments\":0,\r\n   \"refunded_adjustments\":0\r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>in<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nTotal amount in, Must be an amount with up to two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>out<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nTotal amount out, Must be an amount with up to two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>charged_adjustments<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nTotal amount of adjustment charges, Must be an amount with up to two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>refunded_adjustments<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nTotal amount of refund charges, Must be an amount with up to two decimal digits.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"detalle-de-pagos\">Payout Detail<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/reports\/payout\/{TRANSACTION_ID}\/detail\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/reports\/payout\/trwpxhrgfeub9eqdyvqz\/detail?detail_type=IN \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>[\r\n  {\r\n    \"id\": \"trqcwapqeilg596zwrvr\",\r\n    \"authorization\": \"7BXqDL1fjb\",\r\n    \"method\": \"bank_account\",\r\n    \"operation_type\": \"in\",\r\n    \"transaction_type\": \"charge\",\r\n    \"status\": \"completed\",\r\n    \"conciliated\": true,\r\n    \"creation_date\": \"2016-09-13T12:57:34-05:00\",\r\n    \"operation_date\": \"2016-09-13T12:57:34-05:00\",\r\n    \"description\": \"mexzhpxok3houd5lbvz1\",\r\n    \"error_message\": null,\r\n    \"order_id\": null,\r\n    \"bank_account\": {\r\n      \"clabe\": \"113XXXXXXXXXX09568\",\r\n      \"bank_code\": \"113\",\r\n      \"bank_name\": \"VE POR MAS\",\r\n      \"rfc\": \"OPE130906HN4\",\r\n      \"holder_name\": \"persona003\"\r\n    },\r\n    \"amount\": 700,\r\n    \"currency\": \"MXN\"\r\n  },\r\n  {\r\n    \"id\": \"tru6lsl6xpvseqp87vjd\",\r\n    \"authorization\": \"FPVYiN4nyw\",\r\n    \"method\": \"card\",\r\n    \"operation_type\": \"in\",\r\n    \"transaction_type\": \"charge\",\r\n    \"card\": {\r\n      \"type\": \"debit\",\r\n      \"brand\": \"mastercard\",\r\n      \"address\": null,\r\n      \"card_number\": \"555555XXXXXX4444\",\r\n      \"holder_name\": \"persona003\",\r\n      \"expiration_year\": null,\r\n      \"expiration_month\": null,\r\n      \"allows_charges\": false,\r\n      \"allows_payouts\": false,\r\n      \"bank_name\": \"MASARI\",\r\n      \"bank_code\": \"602\"\r\n    },\r\n    \"status\": \"completed\",\r\n    \"conciliated\": true,\r\n    \"creation_date\": \"2016-09-13T12:57:16-05:00\",\r\n    \"operation_date\": \"2016-09-13T12:57:16-05:00\",\r\n    \"description\": \"mexzhpxok3houd5lbvz1\",\r\n    \"error_message\": null,\r\n    \"order_id\": null,\r\n    \"amount\": 2000,\r\n    \"currency\": \"MXN\"\r\n  }\r\n]\r\n<\/code><\/pre>\n<p>Returns a list of the transactions involved in a payout. You must know the payout id.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>transaction_id<\/td>\n<td><em><strong>string<\/strong><\/em> (required, length = 45)<br \/>\nId of the payout you want to get.<\/td>\n<\/tr>\n<tr>\n<td>detail_type<\/td>\n<td><em><strong>string<\/strong><\/em> (<strong><em>IN<\/em><\/strong>, <strong><em>OUT<\/em><\/strong>, <strong><em>CHARGED_ADJUSTMENTS<\/em><\/strong>, <strong><em>REFUNDED_ADJUSTMENTS<\/em><\/strong>)<br \/>\nThe detail type.<\/td>\n<\/tr>\n<tr>\n<td>offset<\/td>\n<td><em><strong>numeric<\/strong><\/em><br \/>\nNumber of records to skip at the beginning, default 0.<\/td>\n<\/tr>\n<tr>\n<td>limit<\/td>\n<td><em><strong>numeric<\/strong><\/em><br \/>\nNumber of required records, default 10.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a list of <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction objects<\/a> or a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"clientes\">Customers<\/h2>\n<p>Customers are Openpay resources that are handled within the Merchant account and can represent users, customers or partners according to the type of Merchant.<\/p>\n<p>You can add cards and bank accounts to the customers so you can make transactions like Charges, Transfers or Payouts.<\/p>\n<h2 id=\"objeto-cliente\">Customer object<\/h2>\n<blockquote><p>Object example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"cz4nkhrlcu9k7qd4lwqx\",\r\n   \"creation_date\":\"2013-11-08T12:04:46-06:00\",\r\n   \"name\":\"Rodrigo\",\r\n   \"last_name\":\"Velazco Perez\",\r\n   \"email\":\"rodrigo.velazco@payments.com\", \r\n   \"phone_number\":\"4425667045\",\r\n   \"external_id\":\"cliente1\",\r\n   \"status\":\"active\",\r\n   \"balance\":103,\r\n   \"address\":{\r\n      \"line1\":\"Av. 5 de febrero No. 1080 int Roble 207\",\r\n      \"line2\":\"Carrillo puerto\",\r\n      \"line3\":\"Zona industrial carrillo puerto\",\r\n      \"postal_code\":\"06500\",\r\n      \"state\":\"Quer\u00e9taro\",\r\n      \"city\":\"Quer\u00e9taro\",\r\n      \"country_code\":\"MX\"\r\n   },\r\n   \"store\": {\r\n       \"reference\": \"OPENPAY02DQ35YOY7\",\r\n       \"barcode_url\": \"https:\/\/sandbox-api.openpay.mx\/barcode\/OPENPAY02DQ35YOY7?width=1&amp;height=45&amp;text=false\"\r\n   },\r\n   \"clabe\": \"646180109400423323\"\r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nCustomer unique identifier.<\/td>\n<\/tr>\n<tr>\n<td>creation_date<\/td>\n<td><strong><em>datetime<\/em><\/strong><br \/>\nDate and time when the customer was created in ISO 8601 format.<\/td>\n<\/tr>\n<tr>\n<td>name<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nName of the customer.<\/td>\n<\/tr>\n<tr>\n<td>last_name<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nCustomer's last name.<\/td>\n<\/tr>\n<tr>\n<td>email<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nLast name of the customer.<\/td>\n<\/tr>\n<tr>\n<td>phone_number<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nCustomer's telephone number.<\/td>\n<\/tr>\n<tr>\n<td>status<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nAccount status of the customer can be active or deleted. If the account is on deleted status, no transaction is allowed.<\/td>\n<\/tr>\n<tr>\n<td>balance<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nAccount balance with two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>clabe<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nCLABE account used to receive funds by transfer from any bank in Mexico.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-direcci-n\">address<\/a><\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nAddress of the customer. It is usually used as shipping address.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-store\">store<\/a><\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nContains reference string to go to Store and make deposits, the url to generate barcode is contained too.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"crear-un-nuevo-cliente\">Create a new customer<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>POST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n   \"name\": \"customer name\",\r\n   \"email\": \"customer_email@me.com\",\r\n   \"requires_account\": false \r\n   }' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"anbnldwgni1way3yp2dw\",\r\n   \"name\":\"customer name\",\r\n   \"last_name\":null,\r\n   \"email\":\"customer_email@me.com\",\r\n   \"phone_number\":null,\r\n   \"address\":null,\r\n   \"creation_date\":\"2014-05-20T16:47:47-05:00\",\r\n   \"external_id\":null,\r\n   \"store\": {\r\n       \"reference\": \"OPENPAY02DQ35YOY7\",\r\n       \"barcode_url\": \"https:\/\/sandbox-api.openpay.mx\/barcode\/OPENPAY02DQ35YOY7?width=1&amp;height=45&amp;text=false\"\r\n   },\r\n   \"clabe\": \"646180109400423323\"\r\n}\r\n<\/code><\/pre>\n<p>Create a customer object.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>external_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nUnique external identifier of the customer assigned for the Merchant.<\/td>\n<\/tr>\n<tr>\n<td>name<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nCustomer's name(s).<\/td>\n<\/tr>\n<tr>\n<td>last_name<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nCustomer's last name.<\/td>\n<\/tr>\n<tr>\n<td>email<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nCustomer's email.<\/td>\n<\/tr>\n<tr>\n<td>requires_account<\/td>\n<td><strong><em>boolean<\/em><\/strong> (opcional, default = false)<br \/>\nSend it with <strong>true<\/strong> value if you need to create the customer with an account to manage the balance.<\/td>\n<\/tr>\n<tr>\n<td>phone_number<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nCustomer's telephone number.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-direcci-n\">address<\/a><\/td>\n<td><strong><em>object<\/em><\/strong> (optional)<br \/>\nAddress of the customer. It is usually used as shipping address.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-cliente\">object customer<\/a> when all the data were sent correctly, or returns an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a> if an error occurred during the creation.<\/p>\n<h2 id=\"actualizar-un-cliente\">Update a customer<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>PUT https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/anbnldwgni1way3yp2dw \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X PUT -d '{\r\n   \"name\": \"customer name\",\r\n   \"email\": \"customer_email@me.com\",\r\n   \"address\":{\r\n      \"city\":\"Queretaro\",\r\n      \"state\":\"Queretaro\",\r\n      \"line1\":\"Calle 10\",\r\n      \"postal_code\":\"76000\",\r\n      \"line2\":\"col. san pablo\",\r\n      \"line3\":\"entre la calle 1 y la 2\",\r\n      \"country_code\":\"MX\"\r\n   },\r\n   \"phone_number\":\"44209087654\"\r\n }' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"anbnldwgni1way3yp2dw\",\r\n   \"name\":\"customer name\",\r\n   \"last_name\":null,\r\n   \"email\":\"customer_email@me.com\",\r\n   \"phone_number\":\"44209087654\",\r\n   \"address\":{\r\n      \"line1\":\"Calle 10\",\r\n      \"line2\":\"col. san pablo\",\r\n      \"line3\":\"entre la calle 1 y la 2\",\r\n      \"state\":\"Queretaro\",\r\n      \"city\":\"Queretaro\",\r\n      \"postal_code\":\"76000\",\r\n      \"country_code\":\"MX\"\r\n   },\r\n   \"store\": {\r\n       \"reference\": \"OPENPAY02DQ35YOY7\",\r\n       \"barcode_url\": \"https:\/\/sandbox-api.openpay.mx\/barcode\/OPENPAY02DQ35YOY7?width=1&amp;height=45&amp;text=false\"\r\n   },\r\n   \"clabe\": \"646180109400423323\",\r\n   \"creation_date\":\"2014-05-20T16:47:47-05:00\",\r\n   \"external_id\":null\r\n}\r\n<\/code><\/pre>\n<p>Updates one or more data of the customer.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>name<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nCustomer's name(s).<\/td>\n<\/tr>\n<tr>\n<td>last_name<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nCustomer's last name.<\/td>\n<\/tr>\n<tr>\n<td>email<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nCustomer's email.<\/td>\n<\/tr>\n<tr>\n<td>phone_number<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nCustomer's telephone number.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-direcci-n\">address<\/a><\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nAddress of the customer. It is usually used as shipping address.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-cliente\">object customer<\/a> with the updated info, or returns an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a> if a problem happened while updating.<\/p>\n<h2 id=\"obtener-un-cliente-existente\">Get an existing customer<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/anbnldwgni1way3yp2dw \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"anbnldwgni1way3yp2dw\",\r\n   \"name\":\"customer name\",\r\n   \"last_name\":null,\r\n   \"email\":\"customer_email@me.com\",\r\n   \"phone_number\":\"44209087654\",\r\n   \"address\":{\r\n      \"line1\":\"Calle 10\",\r\n      \"line2\":\"col. san pablo\",\r\n      \"line3\":\"entre la calle 1 y la 2\",\r\n      \"state\":\"Queretaro\",\r\n      \"city\":\"Queretaro\",\r\n      \"postal_code\":\"76000\",\r\n      \"country_code\":\"MX\"\r\n   },\r\n   \"store\": {\r\n       \"reference\": \"OPENPAY02DQ35YOY7\",\r\n       \"barcode_url\": \"https:\/\/sandbox-api.openpay.mx\/barcode\/OPENPAY02DQ35YOY7?width=1&amp;height=45&amp;text=false\"\r\n   },\r\n   \"clabe\": \"646180109400423323\",\r\n   \"creation_date\":\"2014-05-20T16:47:47-05:00\",\r\n   \"external_id\":null\r\n}\r\n<\/code><\/pre>\n<p>Gets the current information of an existing customer. You only need to specify the id returned when creating the customer.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><em><strong>string<\/strong><\/em> (required, length = 45)<br \/>\nUnique identifier of the customer.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>If the identifier exists, it returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-cliente\">object customer<\/a> with the customer information.<\/p>\n<h2 id=\"eliminar-un-cliente\">Delete a customer<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>DELETE https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/anbnldwgni1way3yp2dw \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X DELETE\r\n<\/code><\/pre>\n<p>Deletes a customer permanently. All the related subscriptions will be canceled. Openpay keeps the operations records.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><em><strong>string<\/strong><\/em> (required, length = 45)<br \/>\nUnique identifier of the customer you want to delete.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>If the customer is deleted correctly, it returns an empty response, if the customer can not be deleted it returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error object<\/a> explaining the reason.<\/p>\n<h2 id=\"listado-de-clientes\">List of customers<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl -g \"https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers?creation[gte]=2013-11-01&amp;limit=2\" \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>[{\r\n   \"id\":\"cpjdhf754ythr65yu9k7q\",\r\n   \"creation_date\":\"2013-11-08T12:04:46-06:00\",\r\n   \"name\":\"Rodrigo\",\r\n   \"last_name\":\"Velazco Perez\",\r\n   \"email\":\"rodrigo.velazco@payments.com\",\r\n   \"phone_number\":\"4425667045\",\r\n   \"status\":\"active\",\r\n   \"balance\":142.5,\r\n   \"store\": {\r\n       \"reference\": \"OPENPAY02DQ35YOY7\",\r\n       \"barcode_url\": \"https:\/\/sandbox-api.openpay.mx\/barcode\/OPENPAY02DQ35YOY7?width=1&amp;height=45&amp;text=false\"\r\n   },\r\n   \"clabe\": \"646180109400423323\"\r\n}, {\r\n   \"id\":\"cz4nkhrlcu9k7qd4lwqx\",\r\n   \"creation_date\":\"2013-11-07T14:54:46-06:00\",\r\n   \"name\":\"Eriberto\",\r\n   \"last_name\":\"Rodriguez Lopez\",\r\n   \"email\":\"eriberto.rodriguez@payments.com\",\r\n   \"phone_number\":\"442\",\r\n   \"status\":\"active\",\r\n   \"balance\":103,\r\n   \"store\": {\r\n       \"reference\": \"OPENPAY02DQWERWJ3\",\r\n       \"barcode_url\": \"https:\/\/sandbox-api.openpay.mx\/barcode\/OPENPAY02DQWERWJ3?width=1&amp;height=45&amp;text=false\"\r\n   },\r\n   \"clabe\": \"646180109400423323\"\r\n}]\r\n<\/code><\/pre>\n<p>Returns a list of registered customers, if you want to delimit the result you may use filters.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<p>You can search using the following parameters as filters.<\/p>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>external_id<\/td>\n<td><em><strong>string<\/strong><\/em><br \/>\nUnique customer id generated by the merchant and associated to the customer by the external_id field of the create customer request<\/td>\n<\/tr>\n<tr>\n<td>creation<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nSame as the customer creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[gte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nAfter the customer creation date .Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[lte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nBefore the customer creation date.Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>offset<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of records to skip at the beginning, default 0.<\/td>\n<\/tr>\n<tr>\n<td>limit<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of required records, default 10.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns an array of <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-cliente\">customer object<\/a>.<\/p>\n<h2 id=\"transferencias\">Wire transfers<\/h2>\n<p>The transfers allow to send funds between accounts of your customers.<\/p>\n<h2 id=\"transferir-entre-clientes\">Transfers between customers<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>POST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/transfers\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/transfers \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{                                            \r\n     \"customer_id\" : \"dvocf97jd20es3tw5laz\",\r\n     \"amount\" : 12.50,          \r\n     \"description\" : \"Transferencia entre cuentas\",\r\n     \"order_id\" : \"oid-1245\"\r\n}' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"amount\":12.50,\r\n   \"authorization\":null,\r\n   \"method\":\"customer\",\r\n   \"operation_type\":\"out\",\r\n   \"currency\":\"MXN\",\r\n   \"transaction_type\":\"transfer\",\r\n   \"status\":\"completed\",\r\n   \"id\":\"twpmbike2jejex3pahzd\",\r\n   \"creation_date\":\"2013-11-15T10:33:19-06:00\",\r\n   \"description\":\"Transferencia entre cuentas\",\r\n   \"error_message\":null,\r\n   \"order_id\":\"oid-1245\",\r\n   \"customer_id\":\"a9pvykxz4g5rg0fplze0\",\r\n   \"store\": {\r\n       \"reference\": \"OPENPAY02DQ35YOY7\",\r\n       \"barcode_url\": \"https:\/\/sandbox-api.openpay.mx\/barcode\/OPENPAY02DQ35YOY7?width=1&amp;height=45&amp;text=false\"\r\n   },\r\n   \"clabe\": \"646180109400423323\"\r\n}\r\n<\/code><\/pre>\n<p>Makes the transfer of funds from one account of the customer to another. The funds will be charged to an origin account and added to a destination account, which will create two transactions.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>customer_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nThe Openpay ID of the customer you want to send the funds.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nAmount to transfer. It must be an amount greater than one peso with up to two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 250)<br \/>\nA description associated to the transfer.<\/td>\n<\/tr>\n<tr>\n<td>order_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nUnique identifier of the transfer. It will be assigned to the withdrawal transaction.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>If the transaction is successful, the response will contain a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a>. This object represents the withdrawal of the account of the current customer. On error, the error object will be returned.<\/p>\n<h2 id=\"obtener-una-transferencia\">Get a transfer<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/transfers\/{TRANSACTION_ID}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/transfers\/twpmbike2jejex3pahzd \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"amount\":12.50,\r\n   \"authorization\":null,\r\n   \"method\":\"customer\",\r\n   \"operation_type\":\"out\",\r\n   \"currency\":\"MXN\",\r\n   \"transaction_type\":\"transfer\",\r\n   \"status\":\"completed\",\r\n   \"id\":\"twpmbike2jejex3pahzd\",\r\n   \"creation_date\":\"2013-11-15T10:33:19-06:00\",\r\n   \"description\":\"Transferencia entre cuentas\",\r\n   \"error_message\":null,\r\n   \"order_id\":\"oid-1245\",\r\n   \"customer_id\":\"dvocf97jd20es3tw5laz\"\r\n}\r\n<\/code><\/pre>\n<p>With the customer identifier and the transfer identifier, you can get the details of the transaction. The output transaction will be on the customer from which the transfer was made, and the entry transaction will be on the customer that received the amount.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>customer_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nIdentifier of the customer.<\/td>\n<\/tr>\n<tr>\n<td>transaction_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nIdentifier of the transfer.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a><\/p>\n<h2 id=\"listado-de-transferencias\">List of transfers<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/transfers\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl -g \"https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/transfers?limit=2\" \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>[\r\n   {\r\n      \"amount\":130.00,\r\n      \"authorization\":null,\r\n      \"method\":\"customer\",\r\n      \"currency\":\"MXN\",\r\n      \"operation_type\":\"out\",\r\n      \"transaction_type\":\"transfer\",\r\n      \"status\":\"completed\",\r\n      \"id\":\"a74mbe4e2j5gc6gfahzd\",\r\n      \"creation_date\":\"2013-09-18T00:31:19-06:00\",\r\n      \"description\":\"Una descripcion\",\r\n      \"error_message\":null,\r\n      \"order_id\":\"20131115103317\",\r\n      \"customer_id\":\"afk4csrazjp1udezj1po\"\r\n   },\r\n   {\r\n      \"amount\":130.00,\r\n      \"authorization\":null,\r\n      \"method\":\"customer\",\r\n      \"currency\":\"MXN\",\r\n      \"operation_type\":\"in\",\r\n      \"transaction_type\":\"transfer\",\r\n      \"status\":\"completed\",\r\n      \"id\":\"a74mbe4e2j5gc6gfahzd\",\r\n      \"creation_date\":\"2013-09-18T00:31:19-06:00\",\r\n      \"description\":\"Una descripcion\",\r\n      \"error_message\":null,\r\n      \"order_id\":null,\r\n      \"customer_id\":\"agdn58ngcnogqmzruz1i\"\r\n   }\r\n]\r\n<\/code><\/pre>\n<p>It allows to consult the entry and output transactions of a customer.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<p>You can search using the following parameters as filters.<\/p>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>creation<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nSame as creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[gte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nAfter the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[lte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nBefore the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>offset<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of records to skip at the beginning, default 0.<\/td>\n<\/tr>\n<tr>\n<td>limit<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of required records, default 10.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>List of <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction objects<\/a> of the transfers made, each one with the identifier of the customer that made it. The transactions will be listed in descending order by creation date.<\/p>\n<h2 id=\"tarjetas\">Cards<\/h2>\n<p>Dentro de la plataforma Openpay podr\u00e1s agregar tarjetas a la cuenta del cliente, eliminarlas, recuperar alguna en espec\u00edfico y listarlas.<\/p>\n<p>You can store multiple debit and \/ or credit cards at Merchant or customer level for making charges later without the need to enter the information again.<\/p>\n<h2 id=\"objeto-tarjeta\">Card Object<\/h2>\n<blockquote><p>Object example<\/p><\/blockquote>\n<pre><code>{\r\n   \"type\":\"debit\",\r\n   \"brand\":\"mastercard\",\r\n   \"address\":{\r\n      \"line1\":\"Av 5 de Febrero\",\r\n      \"line2\":\"Roble 207\",\r\n      \"line3\":\"col carrillo\",\r\n      \"state\":\"Queretaro\",\r\n      \"city\":\"Quer\u00e9taro\",\r\n      \"postal_code\":\"76900\",\r\n      \"country_code\":\"MX\"\r\n   },\r\n   \"id\":\"kgipbqixvjg3gbzowl7l\",\r\n   \"card_number\":\"1111\",\r\n   \"holder_name\":\"Juan Perez Ramirez\",\r\n   \"expiration_year\":\"20\",\r\n   \"expiration_month\":\"12\",\r\n   \"allows_charges\":true,\r\n   \"allows_payouts\":false,\r\n   \"creation_date\":\"2013-12-12T17:50:00-06:00\",\r\n   \"bank_name\":\"DESCONOCIDO\",\r\n   \"bank_code\":\"000\",\r\n   \"customer_id\":\"a2b79p8xmzeyvmolqfja\",\r\n   \"points_card\":true\r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nUnique identifier of the card.<\/td>\n<\/tr>\n<tr>\n<td>creation_date<\/td>\n<td><strong><em>datetime<\/em><\/strong><br \/>\nDate and time when the card was created in ISO 8601 format.<\/td>\n<\/tr>\n<tr>\n<td>holder_name<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nName of the cardholder.<\/td>\n<\/tr>\n<tr>\n<td>card_number<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nCard Number, it can be 16 or 19 digits.<\/td>\n<\/tr>\n<tr>\n<td>cvv2<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nSecurity code as it appears on the back of the card. Usually 3 digits.<\/td>\n<\/tr>\n<tr>\n<td>expiration_month<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nExpiration month as it appears on the card.<\/td>\n<\/tr>\n<tr>\n<td>expiration_year<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nExpiration year as it appears on the card.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-direcci-n\">address<\/a><\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nBilling address of cardholder.<\/td>\n<\/tr>\n<tr>\n<td>allows_charges<\/td>\n<td><strong><em>boolean<\/em><\/strong><br \/>\nIt allows to know if you can make charges to the card.<\/td>\n<\/tr>\n<tr>\n<td>allows_payouts<\/td>\n<td><strong><em>boolean<\/em><\/strong><br \/>\nIt allows to know if you can send payments to the card.<\/td>\n<\/tr>\n<tr>\n<td>brand<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nCard brand: visa, mastercard, carnet or american express.<\/td>\n<\/tr>\n<tr>\n<td>type<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nCard Type: debit, credit, cash, etc.<\/td>\n<\/tr>\n<tr>\n<td>bank_name<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nName of the issuing bank.<\/td>\n<\/tr>\n<tr>\n<td>bank_code<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nCode of the issuing bank.<\/td>\n<\/tr>\n<tr>\n<td>customer_id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nCustomer identifier to which the card belongs. If the card is at Merchant level this value is null.<\/td>\n<\/tr>\n<tr>\n<td>points_card<\/td>\n<td><strong><em>boolean<\/em><\/strong><br \/>\nIndicates whether the card allows the use of reward points.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"crear-una-tarjeta\">Create a card<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/cards\r\nCliente\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/cards\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/cards \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n   \"card_number\":\"4111111111111111\",\r\n   \"holder_name\":\"Juan Perez Ramirez\",\r\n   \"expiration_year\":\"20\",\r\n   \"expiration_month\":\"12\",\r\n   \"cvv2\":\"110\",\r\n   \"device_session_id\" : \"kR1MiQhz2otdIuUlQkbEyitIqVMiI16f\"\r\n }' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"ktrpvymgatocelsciak7\",\r\n   \"type\":\"debit\",\r\n   \"brand\":\"visa\",\r\n   \"card_number\":\"411111XXXXXX1111\",\r\n   \"holder_name\":\"Juan Perez Ramirez\",\r\n   \"expiration_year\":\"20\",\r\n   \"expiration_month\":\"12\",\r\n   \"allows_charges\":true,\r\n   \"allows_payouts\":true,\r\n   \"creation_date\":\"2014-05-21T17:31:01-05:00\",\r\n   \"bank_name\":\"Banamex\",\r\n   \"customer_id\":\"ag4nktpdzebjiye1tlze\",\r\n   \"bank_code\":\"002\"\r\n}\r\n<\/code><\/pre>\n<p>When a card is created the customer must be specified, if the customer is not specified the card will be registered for the Merchant account. Once the card is saved, it can not obtain the number and security code.<\/p>\n<p>When saving a card, an ID will be created which can be used to make card charges, payouts to a card or just for getting the not sensitive card information.<\/p>\n<p>You can use the antifraud system implementation. The <code>device_session_id<\/code> property must be generated using JavaScript API, see <a href=\"https:\/\/github.com\/open-pay\/openpay-js#fraud-detection-using-device-data\">Fraud detection using device data<\/a>.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>holder_name<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 80)<br \/>\nName of the cardholder.<\/td>\n<\/tr>\n<tr>\n<td>card_number<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nCard Number, it can be 16 or 19 digits.<\/td>\n<\/tr>\n<tr>\n<td>cvv2<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nSecurity code as it appears on the back of the card. Usually 3 digits.<\/td>\n<\/tr>\n<tr>\n<td>expiration_month<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nExpiration month as it appears on the card.<\/td>\n<\/tr>\n<tr>\n<td>expiration_year<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nExpiration year as it appears on the card.<\/td>\n<\/tr>\n<tr>\n<td>device_session_id<\/td>\n<td><strong><em>string<\/em><\/strong> (optional, length = 255)<br \/>\nDevice identifier generated by antifraud tool.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-direcci-n\">address<\/a><\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nBilling address of cardholder.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-tarjeta\">card object<\/a> when it is created correctly or returns an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a> if an error occurred during the creation.<\/p>\n<h2 id=\"crear-una-tarjeta-con-token\">Create a card with token<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/cards\r\nCliente\r\nPOST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/cards\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/cards \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n      \"token_id\":\"tokgslwpdcrkhlgxqi9a\",\r\n      \"device_session_id\":\"8VIoXj0hN5dswYHQ9X1mVCiB72M7FY9o\"\r\n   }' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"type\":\"credit\",\r\n   \"brand\":\"visa\",\r\n   \"id\":\"kso4st83wxaibffyt6su\",\r\n   \"card_number\":\"4242\",\r\n   \"holder_name\":\"Juan Perez Ramirez\",\r\n   \"expiration_year\":\"15\",\r\n   \"expiration_month\":\"12\",\r\n   \"allows_charges\":true,\r\n   \"allows_payouts\":false,\r\n   \"creation_date\":\"2014-02-12T10:57:09-06:00\",\r\n   \"bank_name\":\"BANCOMER\",\r\n   \"bank_code\":\"012\",\r\n   \"customer_id\":\"a2b79p8xmzeyvmolqfja\"\r\n}\r\n<\/code><\/pre>\n<p>Creates a card from a token obtained from the browser or from the customer\u2019s device. This way prevents the sensitive card information passes through your servers.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>token_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nToken identifier generated in the the browser or in the customer\u2019s device.<\/td>\n<\/tr>\n<tr>\n<td>device_session_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 255)<br \/>\nIdentifier of the device generated by the antifraud tool.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-tarjeta\">card object<\/a><\/p>\n<h2 id=\"obtener-una-tarjeta\">Get a card<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/cards\/{CARD_ID}\r\nCliente\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/cards\/{CARD_ID}\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/cards\/ktrpvymgatocelsciak7 \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"ktrpvymgatocelsciak7\",\r\n   \"type\":\"debit\",\r\n   \"brand\":\"visa\",\r\n   \"card_number\":\"411111XXXXXX1111\",\r\n   \"holder_name\":\"Juan Perez Ramirez\",\r\n   \"expiration_year\":\"20\",\r\n   \"expiration_month\":\"12\",\r\n   \"allows_charges\":true,\r\n   \"allows_payouts\":true,\r\n   \"creation_date\":\"2014-05-21T17:31:01-05:00\",\r\n   \"bank_name\":\"Banamex\",\r\n   \"customer_id\":\"ag4nktpdzebjiye1tlze\",\r\n   \"bank_code\":\"002\"\r\n}\r\n<\/code><\/pre>\n<p>It obtains the details of the card by using its id.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nCard unique identifier.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-tarjeta\">card object<\/a><\/p>\n<h2 id=\"consulta-de-puntos\">Card points<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/cards\/{CARD_ID}\/points\r\nCliente\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/cards\/{CARD_ID}\/points\r\nToken\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/tokens\/{TOKEN_ID}\/points\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl -g \"https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/cards\/ktrpvymgatocelsciak7\/points\" \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>[\r\n   {\r\n      \"points_type\": \"santander\",\r\n      \"remaining_points\":\"300\",\r\n      \"remaining_mxn\":\"22.5\"\r\n   }\r\n]\r\n<\/code><\/pre>\n<p>Returns the card point balance. Is applicable only for Santander, Scotiabank and Bancomer points.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<p>You can get the card points of a merchant or customer using the card id.<\/p>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nCard unique identifier.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Also you can get the card points of a merchant using the token.<\/p>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nIdentifier token<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>points_type<\/td>\n<td>Points type accepted by the card (Santander, Scotiabank or Bancomer)<\/td>\n<\/tr>\n<tr>\n<td>remaining_points<\/td>\n<td>Number of remaining points<\/td>\n<\/tr>\n<tr>\n<td>remaining_mxn<\/td>\n<td>Balance remaining points in pesos<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"eliminar-una-tarjeta\">Delete a card<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nDELETE https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/cards\/{CARD_ID}\r\nCliente\r\nDELETE https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/cards\/{CARD_ID}\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/cards\/ktrpvymgatocelsciak7 \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -X DELETE\r\n<\/code><\/pre>\n<p>Deletes a card of the customer or Merchant. After deleting it won\u2019t be possible to make movements with that card, however, all records of the transactions you have made will be kept and will be available on the dashboard.<\/p>\n<p>To remove it is only necessary to provide the card identifier.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nCard unique identifier.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>If the card is removed correctly the answer is empty, if it can not be deleted a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error object<\/a> explaining the reason.<\/p>\n<h2 id=\"listado-de-tarjetas\">List of cards<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\r\nCliente\r\nGET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/cards\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl -g \"https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/cards?limit=2\" \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>[\r\n   {\r\n      \"id\":\"kxq1rpdymlcpxekvjsxm\",\r\n      \"card_number\":\"1118\",\r\n      \"holder_name\":\"Pedro Paramo\",\r\n      \"expiration_year\":\"15\",\r\n      \"expiration_month\":\"12\",\r\n      \"allows_charges\":true,\r\n      \"allows_payouts\":true,\r\n      \"creation_date\":\"2013-11-20T09:22:25-06:00\",\r\n      \"bank_name\":\"BBVA BANCOMER\",\r\n      \"bank_code\":\"012\",\r\n      \"type\":\"debit\",\r\n      \"brand\":\"mastercard\"\r\n   },\r\n   {\r\n      \"id\":\"kgjy0jiami01kkpdoywr\",\r\n      \"card_number\":\"1111\",\r\n      \"holder_name\":\"Pedro Paramo\",\r\n      \"expiration_year\":\"15\",\r\n      \"expiration_month\":\"12\",\r\n      \"allows_charges\":true,\r\n      \"allows_payouts\":true,\r\n      \"creation_date\":\"2013-11-19T13:26:12-06:00\",\r\n      \"bank_name\":\"BBVA BANCOMER\",\r\n      \"bank_code\":\"012\",\r\n      \"type\":\"debit\",\r\n      \"brand\":\"mastercard\"\r\n   }\r\n]\r\n<\/code><\/pre>\n<p>Returns a list of registered Merchant or customer cards, if you want to narrow the result you can use filters.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<p>You can search using the following parameters as filters.<\/p>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>creation<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nSame as creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[gte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nAfter the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[lte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nBefore the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>offset<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of records to skip at the beginning, default 0.<\/td>\n<\/tr>\n<tr>\n<td>limit<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of required records, default 10.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>List of <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-tarjeta\">card objects<\/a> registered according to the parameters provided, sorted by creation date in descending order.<\/p>\n<h2 id=\"actualizar-tarjeta\">Updating a card<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>Comercio\r\nPUT https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/cards\/{CARD_ID}\r\nCliente\r\nPUT https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/cards\/{CARD_ID}\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/cards\/kysc8pycq8hnlzivk1x4 \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X PUT -d '{\r\n      \"cvv2\":\"000\"\r\n   }' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n}\r\n<\/code><\/pre>\n<p>Updates the card data from the browser or from the customer\u2019s device. It also allows to send a cvv2 code that will be used in the next transaction done with this card. This prevents sensitive information from passing through your servers.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>holder_name<\/td>\n<td><strong><em>string<\/em><\/strong> (optional)<br \/>\nName of the cardholder.<\/td>\n<\/tr>\n<tr>\n<td>cvv2<\/td>\n<td><strong><em>string<\/em><\/strong> (optional)<br \/>\nSecurity code as it appears on the back of the card. Usually 3 digits.<\/td>\n<\/tr>\n<tr>\n<td>expiration_month<\/td>\n<td><strong><em>numeric<\/em><\/strong> (optional)<br \/>\nExpiration month as it appears on the card.<\/td>\n<\/tr>\n<tr>\n<td>expiration_year<\/td>\n<td><strong><em>numeric<\/em><\/strong> (optional)<br \/>\nExpiration year as it appears on the card.<\/td>\n<\/tr>\n<tr>\n<td>merchant_id<\/td>\n<td><strong><em>string<\/em><\/strong> (conditional)<br \/>\nMerchant ID to use to validate this card. Required when using a merchant group.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns an empty JSON object. Please consider that this response may be extended in the future.<\/p>\n<h2 id=\"cuentas-bancarias\">Bank Accounts<\/h2>\n<p>You can store multiple bank accounts by Merchant or customer for withdraw funds later.<\/p>\n<h2 id=\"objeto-cuenta-bancaria\">Bank account object<\/h2>\n<blockquote><p>Object example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"brppwl9nwmruogk2do0j\",\r\n   \"clabe\":\"032180000118359719\",\r\n   \"bank_code\":\"032\",\r\n   \"bank_name\":\"IXE\",\r\n   \"alias\":null,\r\n   \"holder_name\":\"Juan Hern\u00e1ndez S\u00e1nchez\",\r\n   \"creation_date\":\"2013-11-14T12:29:18-06shell00\"\r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nID of the bank account.<\/td>\n<\/tr>\n<tr>\n<td>holder_name<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nHolder\u2019s full name.<\/td>\n<\/tr>\n<tr>\n<td>alias<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nName by which the bank account is identified.<\/td>\n<\/tr>\n<tr>\n<td>clabe<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nCLABE number assigned to the account.<\/td>\n<\/tr>\n<tr>\n<td>bank_name<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nAbbreviated name of the bank where the account resides, based on the following catalog of <a href=\"http:\/\/es.wikipedia.org\/wiki\/CLABE#C.C3.B3digo_de_Banco\">Bank codes<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>bank_code<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nBank code where the account resides, based on the following catalog <a href=\"http:\/\/es.wikipedia.org\/wiki\/CLABE#C.C3.B3digo_de_Banco\">Bank codes<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>creation_date<\/td>\n<td><strong><em>datetime<\/em><\/strong><br \/>\nDate and time when the bank account was created in ISO 8601 format.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"crear-una-cuenta-bancaria\">Create a bank account<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>POST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/bankaccounts\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/bankaccounts \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n   \"clabe\":\"032180000118359719\",\r\n   \"alias\":\"Cuenta principal\",\r\n   \"holder_name\":\"Juan Hern\u00e1ndez S\u00e1nchez\"\r\n}'\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"buyj4apkwilpp2jfxr9r\",\r\n   \"clabe\":\"032XXXXXXXXXX59719\",\r\n   \"bank_code\":\"032\",\r\n   \"bank_name\":\"IXE\",\r\n   \"alias\":\"Cuenta principal\",\r\n   \"holder_name\":\"Juan Hern\u00e1ndez S\u00e1nchez\",\r\n   \"creation_date\":\"2014-05-22T11:02:10-05:00\"\r\n}\r\n<\/code><\/pre>\n<p>Creates and assigns a bank account to a specific customer.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>holder_name<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 80)<br \/>\nHolder\u2019s full name.<\/td>\n<\/tr>\n<tr>\n<td>alias<\/td>\n<td><strong><em>string<\/em><\/strong> (optional, length = 45)<br \/>\nName by which the bank account is identified.<\/td>\n<\/tr>\n<tr>\n<td>clabe<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nCLABE number assigned to the account.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-cuenta-bancaria\">bank account object<\/a> or an error when a there is a problem.<\/p>\n<h2 id=\"obtener-una-cuenta-bancaria\">Get a bank account<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/bankaccounts\/{BANK_ACCOUNT_ID}\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/bankaccounts\/buyj4apkwilpp2jfxr9r \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"buyj4apkwilpp2jfxr9r\",\r\n   \"clabe\":\"032XXXXXXXXXX59719\",\r\n   \"bank_code\":\"032\",\r\n   \"bank_name\":\"IXE\",\r\n   \"alias\":\"Cuenta principal\",\r\n   \"holder_name\":\"Juan Hern\u00e1ndez S\u00e1nchez\",\r\n   \"creation_date\":\"2014-05-22T11:02:10-05:00\"\r\n}\r\n<\/code><\/pre>\n<p>It obtains the details of the bank account assigned to a customer.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nUnique identifier of the bank account.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-cuenta-bancaria\">bank account object<\/a><\/p>\n<h2 id=\"eliminar-una-cuenta-bancaria\">Delete a bank account<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>DELETE https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/bankaccounts\/{BANK_ACCOUNT_ID}\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/bankaccounts\/buyj4apkwilpp2jfxr9r \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -X DELETE\r\n<\/code><\/pre>\n<p>Deletes the bank account associated with the customer. The transactions that are associated with this account are unchanged and will continue for you to consult them.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nUnique identifier of the bank account.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>If the bank account is removed correctly the answer is empty, if it can not be deleted a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error object<\/a> explaining the reason.<\/p>\n<h2 id=\"listado-de-cuentas-bancarias\">List of bank accounts<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/bankaccounts\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl -g \"https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/bankaccounts?limit=2\" \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>[{\r\n   \"id\":\"brppwl9nwmruogk2do0j\",\r\n   \"clabe\":\"032180000118359719\",\r\n   \"bank_code\":\"032\",\r\n   \"bank_name\":\"IXE\",\r\n   \"alias\":null,\r\n   \"holder_name\":\"Juan Hern\u00e1ndez S\u00e1nchez\",\r\n   \"creation_date\":\"2013-11-14T12:29:18-06:00\"\r\n},\r\n{\r\n   \"id\":\"bb0zt72rxoyiwz9jzzai\",\r\n   \"clabe\":\"012680012426485980\",\r\n   \"bank_code\":\"012\",\r\n   \"bank_name\":\"BANCOMER\",\r\n   \"alias\":null,\r\n   \"holder_name\":\"Juan Hern\u00e1ndez S\u00e1nchez\",\r\n   \"creation_date\":\"2013-11-14T18:07:45-06:00\"\r\n}]\r\n<\/code><\/pre>\n<p>Returns the details of all the bank accounts of the customer specified on the request.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<p>You can search using the following parameters as filters.<\/p>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>creation<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nSame as creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[gte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nAfter the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[lte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nBefore the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>offset<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of records to skip at the beginning, default 0.<\/td>\n<\/tr>\n<tr>\n<td>limit<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of required records, default 10.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>List of <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-cuenta-bancaria\">objetos cuenta bancaria<\/a> registered according to the parameters provided, sorted by creation date in descending order.<\/p>\n<h2 id=\"planes\">Plans<\/h2>\n<p>Plans are an Openpay resource that allows create templates for subscriptions. Using plans you can define the amount and frequency of recurrent charges.<\/p>\n<h2 id=\"objeto-plan\">Plan Object<\/h2>\n<blockquote><p>Object example<\/p><\/blockquote>\n<pre><code>{\r\n    \"name\": \"Curso de ingles\",\r\n    \"status\": \"active\",\r\n    \"amount\": 150,\r\n    \"currency\": \"MXN\",\r\n    \"id\": \"patpflacwilazguj6bem\",\r\n    \"creation_date\": \"2013-12-13T09:43:52-06:00\",\r\n    \"repeat_every\": 1,\r\n    \"repeat_unit\": \"month\",\r\n    \"retry_times\": 2,\r\n    \"status_after_retry\": \"cancelled\",\r\n    \"trial_days\": 30\r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nUnique plan identifier.<\/td>\n<\/tr>\n<tr>\n<td>creation_date<\/td>\n<td><strong><em>datetime<\/em><\/strong><br \/>\nDate and time in which the plan was created in ISO 8601 format.<\/td>\n<\/tr>\n<tr>\n<td>name<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nPlan name.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nAmount that will be applied once the subscription is charged. It has to be more than zero and it can have up to two decimal places.<\/td>\n<\/tr>\n<tr>\n<td>currency<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nCurrency used in the operation, by default is MXN (Mexican pesos).<\/td>\n<\/tr>\n<tr>\n<td>repeat_every<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nTime units in which the subscription will be charged. For example, repeat_unit=month and repeat_every=2 indicates that it will be charged every 2 months.<\/td>\n<\/tr>\n<tr>\n<td>repeat_unit<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nDescribes the charge unit frequency. It can be weekly(week), monthly(month) or yearly (year).<\/td>\n<\/tr>\n<tr>\n<td>retry_times<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of attempts to try to charge the subscription. When the attempts have been exhausted, the status field is determined by the field status_after_retry.<\/td>\n<\/tr>\n<tr>\n<td>status<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nPlan status can be active or deleted. If the plan is in deleted state it doesn\u2019t allow to register new subscriptions under this plan but existing subscriptions will be charged.<\/td>\n<\/tr>\n<tr>\n<td>status_after_retry<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nThis field indicates the status in which the subscription will be set once all the charge attempts have been exhausted. It can be unpaid or cancelled.<\/td>\n<\/tr>\n<tr>\n<td>trial_days<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of trial days this subscription will have by default.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"crear-un-nuevo-plan\">Create a new Plan<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>POST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/plans\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/plans \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n  \"amount\": 150.00,\r\n  \"status_after_retry\": \"cancelled\",\r\n  \"retry_times\": 2,\r\n  \"name\": \"Curso de ingles\",\r\n  \"repeat_unit\": \"month\",\r\n  \"trial_days\": \"30\",\r\n  \"repeat_every\": \"1\"\r\n}' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"p8e6x3hafqqsbmnoevrt\",\r\n   \"name\":\"Curso de ingles\",\r\n   \"status\":\"active\",\r\n   \"amount\":150.00,\r\n   \"currency\":\"MXN\",\r\n   \"creation_date\":\"2014-05-22T12:29:31-05:00\",\r\n   \"repeat_every\":1,\r\n   \"repeat_unit\":\"month\",\r\n   \"retry_times\":2,\r\n   \"status_after_retry\":\"cancelled\",\r\n   \"trial_days\":30\r\n}\r\n<\/code><\/pre>\n<p>Creates a new plan for allowing customers to subscribe.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>name<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 255)<br \/>\nPlan name.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nAmount that will be applied once the subscription is charged. It has to be more than zero and it can have up to two decimal places.<\/td>\n<\/tr>\n<tr>\n<td>repeat_every<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nTime units in which the subscription will be charged. For example, repeat_unit=month and repeat_every=2 indicates that it will be charged every 2 months.<\/td>\n<\/tr>\n<tr>\n<td>repeat_unit<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nDescribes the charge unit frequency. It can be weekly(week), monthly(month) or yearly (year).<\/td>\n<\/tr>\n<tr>\n<td>retry_times<\/td>\n<td><strong><em>numeric<\/em><\/strong> (optional)<br \/>\nNumber of attempts to try to charge the subscription. When the attempts have been exhausted, the status field is determined by the field status_after_retry.<\/td>\n<\/tr>\n<tr>\n<td>status_after_retry<\/td>\n<td><strong><em>string<\/em><\/strong> (requerido, valores = \u201cUNPAID\/CANCELLED\u201d)<br \/>\nThis field indicates the status in which the subscription will be set once all the charge attempts have been exhausted. It can be unpaid or cancelled.<\/td>\n<\/tr>\n<tr>\n<td>trial_days<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nNumber of trial days this subscription will have by default.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-plan\">plan object<\/a> or an error when a there is a problem.<\/p>\n<h2 id=\"actualizar-un-plan-existente\">Update existing plans.<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>PUT https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/plans\/{PLAN_ID}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/plans\/p8e6x3hafqqsbmnoevrt \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X PUT -d '{\r\n      \"name\": \"Curso de aleman\",\r\n      \"trial_days\": \"60\"\r\n   }' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"p8e6x3hafqqsbmnoevrt\",\r\n   \"name\":\"Curso de aleman\",\r\n   \"status\":\"active\",\r\n   \"amount\":150.00,\r\n   \"currency\":\"MXN\",\r\n   \"creation_date\":\"2014-05-22T12:29:31-05:00\",\r\n   \"repeat_every\":1,\r\n   \"repeat_unit\":\"month\",\r\n   \"retry_times\":2,\r\n   \"status_after_retry\":\"cancelled\",\r\n   \"trial_days\":60\r\n}\r\n<\/code><\/pre>\n<p>Updates the plan information. It requires a plan id and only certain fields can be updated.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>name<\/td>\n<td><strong><em>string<\/em><\/strong> (optional, length = 80)<br \/>\nPlan name.<\/td>\n<\/tr>\n<tr>\n<td>trial_days<\/td>\n<td><strong><em>numeric<\/em><\/strong> (optional)<br \/>\nNumber of trial days this subscription will have by default.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-plan\">plan object<\/a> with the updated information or an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a> if a problem happened while updating.<\/p>\n<h2 id=\"obtener-un-plan\">Get a plan<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/plans\/{PLAN_ID}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/plans\/p8e6x3hafqqsbmnoevrt \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"p8e6x3hafqqsbmnoevrt\",\r\n   \"name\":\"Curso de aleman\",\r\n   \"status\":\"active\",\r\n   \"amount\":150.00,\r\n   \"currency\":\"MXN\",\r\n   \"creation_date\":\"2014-05-22T12:29:31-05:00\",\r\n   \"repeat_every\":1,\r\n   \"repeat_unit\":\"month\",\r\n   \"retry_times\":2,\r\n   \"status_after_retry\":\"cancelled\",\r\n   \"trial_days\":60\r\n}\r\n<\/code><\/pre>\n<p>It gets the plan details.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nPlan identifier.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-plan\">plan object<\/a><\/p>\n<h2 id=\"eliminar-un-plan\">Delete a plan<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>DELETE https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/plans\/{PLAN_ID}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/plans\/p8e6x3hafqqsbmnoevrt \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -X DELETE\r\n<\/code><\/pre>\n<p>When a plan is deleted it won\u2019t allow to create more subscriptions associated with it, however the subscriptions already associated will continue to be charged.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nIdentifier of the plan that will be deleted.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>If the plan is deleted correctly the response will be empty, if it cannot be deleted an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error object<\/a> explaining the reason.<\/p>\n<h2 id=\"listado-de-planes\">Plan list<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/plans\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl -g \"https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/plans?limit=10\" \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>[\r\n    {\r\n        \"name\": \"Curso de aleman\",\r\n        \"status\": \"active\",\r\n        \"amount\": 150,\r\n        \"currency\": \"MXN\",\r\n        \"id\": \"patpflacwilazguj6bem\",\r\n        \"creation_date\": \"2013-12-13T09:43:52-06:00\",\r\n        \"repeat_every\": 1,\r\n        \"repeat_unit\": \"month\",\r\n        \"retry_times\": 2,\r\n        \"status_after_retry\": \"cancelled\",\r\n        \"trial_days\": 60\r\n    },\r\n    {\r\n        \"name\": \"Curso de ingles\",\r\n        \"status\": \"active\",\r\n        \"amount\": 150,\r\n        \"currency\": \"MXN\",\r\n        \"id\": \"pjl7wfryrrd1tznr0fnl\",\r\n        \"creation_date\": \"2013-12-13T11:36:40-06:00\",\r\n        \"repeat_every\": 1,\r\n        \"repeat_unit\": \"month\",\r\n        \"retry_times\": 2,\r\n        \"status_after_retry\": \"cancelled\",\r\n        \"trial_days\": 30\r\n    }\r\n]\r\n<\/code><\/pre>\n<p>Returns the details of all active plans.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<p>You can search using the following parameters:<\/p>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>creation<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nSame as creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[gte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nAfter the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[lte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nBefore the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>offset<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of records to skip at the beginning, default 0.<\/td>\n<\/tr>\n<tr>\n<td>limit<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of required records, default 10.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>List of <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-plan\">plan objects<\/a> registered according to the parameters provided, sorted by creation date in descending order.<\/p>\n<h2 id=\"suscripciones\">Subscriptions<\/h2>\n<p>Subscriptions allow you to associate a customer and a card so that recurring charges can be made.<\/p>\n<p>In order to subscribe a client it is necessary to first <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#crear-una-nuevo-plan\">create a plan<\/a>.<\/p>\n<h2 id=\"objeto-suscripci-n\">Subscription object<\/h2>\n<blockquote><p>Object example<\/p><\/blockquote>\n<pre><code>{\r\n    \"status\": \"trial\",\r\n    \"card\": {\r\n        \"type\": \"debit\",\r\n        \"brand\": \"mastercard\",\r\n        \"card_number\": \"1111\",\r\n        \"holder_name\": \"Juan Perez Ramirez\",\r\n        \"expiration_year\": \"20\",\r\n        \"expiration_month\": \"12\",\r\n        \"allows_charges\": true,\r\n        \"allows_payouts\": false,\r\n        \"creation_date\": \"2013-12-13T12:39:46-06:00\",\r\n        \"bank_name\": \"DESCONOCIDO\",\r\n        \"customer_id\": null,\r\n        \"bank_code\": \"000\"\r\n    },\r\n    \"id\": \"svxdm1suclzipbi4pavm\",\r\n    \"cancel_at_period_end\": false,\r\n    \"charge_date\": \"2014-01-12\",\r\n    \"creation_date\": \"2013-12-13T12:39:46-06:00\",\r\n    \"current_period_number\": 0,\r\n    \"period_end_date\": \"2014-01-11\",\r\n    \"trial_end_date\": \"2014-01-11\",\r\n    \"plan_id\": \"pjl7wfryrrd1tznr0fnl\",\r\n    \"customer_id\": \"a2b79p8xmzeyvmolqfja\"\r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nUnique plan identifier.<\/td>\n<\/tr>\n<tr>\n<td>creation_date<\/td>\n<td><strong><em>datetime<\/em><\/strong><br \/>\nDate and time in which the subscription was created using ISO 8601 format.<\/td>\n<\/tr>\n<tr>\n<td>cancel_at_period_end<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nIndicates if the subscription has been canceled at the end of the period.<\/td>\n<\/tr>\n<tr>\n<td>charge_date<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nDate in which the subscription will be charged.<\/td>\n<\/tr>\n<tr>\n<td>current_period_number<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nIndicates the current period to be charged.<\/td>\n<\/tr>\n<tr>\n<td>period_end_date<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nDate in which the current period ends, it\u2019s one day before the next charge.<\/td>\n<\/tr>\n<tr>\n<td>trial_end_date<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nDate in which the trial period ends. One day after this date the first charge is applied.<\/td>\n<\/tr>\n<tr>\n<td>plan_id<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nPlan identifier in which this subscription will be created.<\/td>\n<\/tr>\n<tr>\n<td>status<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nSubscription status, it can be active, trial, past_due, unpaid or cancelled. If the subscription has a trial period, the trial period is applied, if it doesn\u2019t have or when the trial period ends and the first payment is executed it changes to active. When the charge was unable to be completed it changes to past_due. When all the charge tries has been completed according to the plan configuration it can change to unpaid or cancelled. When it\u2019s marked as unpaid and the subscription wants to be reactivated it\u2019s required to update the subscription payment method(card). In any other case, the status is set to cancelled.<\/td>\n<\/tr>\n<tr>\n<td>customer_id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nCustomer identifier for the subscription owner.<\/td>\n<\/tr>\n<tr>\n<td>card<\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nPayment method for the subscription. See <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-tarjeta\">card object<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"crear-una-nueva-suscripci-n\">Create a new Subscription<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>POST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/subscriptions\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/subscriptions \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n   \"card\":{\r\n      \"card_number\":\"4111111111111111\",\r\n      \"holder_name\":\"Juan Perez Ramirez\",\r\n      \"expiration_year\":\"20\",\r\n      \"expiration_month\":\"12\",\r\n      \"cvv2\":\"110\",\r\n      \"device_session_id\":\"kR1MiQhz2otdIuUlQkbEyitIqVMiI16f\"\r\n   },\r\n   \"plan_id\":\"pbi4kb8hpb64x0uud2eb\"\r\n}' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"s0gmyor4yqtyv1miqwr0\",\r\n   \"status\":\"trial\",\r\n   \"card\":{\r\n      \"type\":\"debit\",\r\n      \"brand\":\"visa\",\r\n      \"address\":null,\r\n      \"card_number\":\"411111XXXXXX1111\",\r\n      \"holder_name\":\"Juan Perez Ramirez\",\r\n      \"expiration_year\":\"20\",\r\n      \"expiration_month\":\"12\",\r\n      \"allows_charges\":true,\r\n      \"allows_payouts\":true,\r\n      \"bank_name\":\"Banamex\",\r\n      \"bank_code\":\"002\"\r\n   },\r\n   \"cancel_at_period_end\":false,\r\n   \"charge_date\":\"2014-06-21\",\r\n   \"creation_date\":\"2014-05-22T15:56:18-05:00\",\r\n   \"current_period_number\":0,\r\n   \"period_end_date\":\"2014-06-20\",\r\n   \"trial_end_date\":\"2014-06-20\",\r\n   \"plan_id\":\"pbi4kb8hpb64x0uud2eb\",\r\n   \"customer_id\":\"ag4nktpdzebjiye1tlze\"\r\n}\r\n<\/code><\/pre>\n<p>Create a new subscription for an existing customer. You can use an existing card or you can send the info of the card where the charges will be made, in these you can include the property <code>device_session_id<\/code> to use the antifraud tool, see <a href=\"https:\/\/github.com\/open-pay\/openpay-js#fraud-detection-using-device-data\">Fraud detection using device data<\/a>.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>plan_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nPlan identifier in which this subscription will be created.<\/td>\n<\/tr>\n<tr>\n<td>trial_end_date<\/td>\n<td><strong><em>string<\/em><\/strong> (optional, length = 10)<br \/>\nIndicates the customer trial end date. If it\u2019s not indicated the plan will be used to calculate it. If the date is in the past it will be interpreted as a subscription with no trial. Format: yyyy-mm-dd.<\/td>\n<\/tr>\n<tr>\n<td>source_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required if the card is not sent, length = 45)<br \/>\nCard token identifier, or the customer registered card which will be used to charge the subscription.<\/td>\n<\/tr>\n<tr>\n<td>card<\/td>\n<td><strong><em>object<\/em><\/strong> (required if the source_id is not present)<br \/>\nPayment method for the subscription. See <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-tarjeta\">card object<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns the created <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-suscripci\u00f3n\">subscription object<\/a> or an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a> if an error occurred during the creation.<\/p>\n<h2 id=\"actualizar-una-suscripci-n\">Updating a Subscription<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>PUT https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/subscriptions\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/subscriptions\/s0gmyor4yqtyv1miqwr0 \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X PUT -d '{\r\n  \"trial_end_date\": \"2016-01-11\",\r\n   \"card\": {\r\n        \"card_number\": \"343434343434343\",\r\n        \"holder_name\": \"Juan Perez Ramirez\",\r\n        \"expiration_year\": \"20\",\r\n        \"expiration_month\": \"12\",\r\n        \"cvv2\":\"1234\"\r\n    }\r\n}' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"s0gmyor4yqtyv1miqwr0\",\r\n   \"status\":\"trial\",\r\n   \"card\":{\r\n      \"type\":\"credit\",\r\n      \"brand\":\"american_express\",\r\n      \"address\":null,\r\n      \"card_number\":\"343434XXXXX4343\",\r\n      \"holder_name\":\"Juan Perez Ramirez\",\r\n      \"expiration_year\":\"20\",\r\n      \"expiration_month\":\"12\",\r\n      \"allows_charges\":true,\r\n      \"allows_payouts\":false,\r\n      \"bank_name\":\"AMERICAN EXPRESS\",\r\n      \"bank_code\":\"103\"\r\n   },\r\n   \"cancel_at_period_end\":false,\r\n   \"charge_date\":\"2016-01-12\",\r\n   \"creation_date\":\"2014-05-22T15:56:18-05:00\",\r\n   \"current_period_number\":0,\r\n   \"period_end_date\":\"2016-01-11\",\r\n   \"trial_end_date\":\"2016-01-11\",\r\n   \"plan_id\":\"pbi4kb8hpb64x0uud2eb\",\r\n   \"customer_id\":\"ag4nktpdzebjiye1tlze\"\r\n}\r\n<\/code><\/pre>\n<p>Updates the information of an active subscription.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>cancel_at_period_end<\/td>\n<td><strong><em>booelan<\/em><\/strong> (optional)<br \/>\nIndicates if the subscription has been canceled at the end of the period.<\/td>\n<\/tr>\n<tr>\n<td>trial_end_date<\/td>\n<td><strong><em>string<\/em><\/strong> (optional, length = 10)<br \/>\nIndicates the customer trial end date. If it\u2019s not indicated the plan will be used to calculate it. If the date is in the past it will be interpreted as a subscription with no trial. Format: yyyy-mm-dd.<\/td>\n<\/tr>\n<tr>\n<td>source_id<\/td>\n<td><strong><em>string<\/em><\/strong> (optional, length = 45)<br \/>\nCard token identifier, or the customer registered card which will be used to charge the subscription.<\/td>\n<\/tr>\n<tr>\n<td>card<\/td>\n<td><strong><em>object<\/em><\/strong> (optional)<br \/>\nPayment method for the subscription. See <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-tarjeta\">card object<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns the created <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-suscripci\u00f3n\">subscription object<\/a> actualizado o una <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a> if a problem happened while updating.<\/p>\n<h2 id=\"obtener-un-suscripci-n\">Get a Subscription<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/subscriptions\/{SUBSCRIPTION_ID}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/subscriptions\/s0gmyor4yqtyv1miqwr0 \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"s0gmyor4yqtyv1miqwr0\",\r\n   \"status\":\"trial\",\r\n   \"card\":{\r\n      \"type\":\"credit\",\r\n      \"brand\":\"american_express\",\r\n      \"address\":null,\r\n      \"card_number\":\"343434XXXXX4343\",\r\n      \"holder_name\":\"Juan Perez Ramirez\",\r\n      \"expiration_year\":\"20\",\r\n      \"expiration_month\":\"12\",\r\n      \"allows_charges\":true,\r\n      \"allows_payouts\":false,\r\n      \"bank_name\":\"AMERICAN EXPRESS\",\r\n      \"bank_code\":\"103\"\r\n   },\r\n   \"cancel_at_period_end\":false,\r\n   \"charge_date\":\"2016-01-12\",\r\n   \"creation_date\":\"2014-05-22T15:56:18-05:00\",\r\n   \"current_period_number\":0,\r\n   \"period_end_date\":\"2016-01-11\",\r\n   \"trial_end_date\":\"2016-01-11\",\r\n   \"plan_id\":\"pbi4kb8hpb64x0uud2eb\",\r\n   \"customer_id\":\"ag4nktpdzebjiye1tlze\"\r\n}\r\n<\/code><\/pre>\n<p>Gets the details of a customer subscription.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nSubscription identifier.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-suscripci\u00f3n\">subscription object<\/a><\/p>\n<h2 id=\"cancelar-suscripci-n\">Cancel a Subscription<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>DELETE https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/subscriptions\/{SUBSCRIPTION_ID}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/subscriptions\/s0gmyor4yqtyv1miqwr0 \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -X DELETE\r\n<\/code><\/pre>\n<p>Immediately cancels a customer subscription. No more charges will be made to the card and all pending charges will be cancelled.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nIdentifier of the plan that will be deleted.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>If the response was successfully cancelled the response will be empty. Otherwise an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error object<\/a> explaining the reason.<\/p>\n<h2 id=\"listado-de-suscripciones\">Subscription list<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/customers\/{CUSTOMER_ID}\/subscriptions\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl -g \"https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/customers\/ag4nktpdzebjiye1tlze\/subscriptions?limit=10\" \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>[\r\n   {\r\n      \"id\":\"s0gmyor4yqtyv1miqwr0\",\r\n      \"status\":\"trial\",\r\n      \"card\":{\r\n         \"type\":\"credit\",\r\n         \"brand\":\"american_express\",\r\n         \"address\":null,\r\n         \"card_number\":\"343434XXXXX4343\",\r\n         \"holder_name\":\"Juan Perez Ramirez\",\r\n         \"expiration_year\":\"20\",\r\n         \"expiration_month\":\"12\",\r\n         \"allows_charges\":true,\r\n         \"allows_payouts\":false,\r\n         \"bank_name\":\"AMERICAN EXPRESS\",\r\n         \"bank_code\":\"103\"\r\n      },\r\n      \"cancel_at_period_end\":false,\r\n      \"charge_date\":\"2016-01-12\",\r\n      \"creation_date\":\"2014-05-22T15:56:18-05:00\",\r\n      \"current_period_number\":0,\r\n      \"period_end_date\":\"2016-01-11\",\r\n      \"trial_end_date\":\"2016-01-11\",\r\n      \"plan_id\":\"pbi4kb8hpb64x0uud2eb\",\r\n      \"customer_id\":\"ag4nktpdzebjiye1tlze\"\r\n   }\r\n]\r\n<\/code><\/pre>\n<p>Returns all the subscriptions active for an specific customer.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<p>You can search using the following parameters:<\/p>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>creation<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nSame as creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[gte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nAfter the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[lte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nBefore the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>offset<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of records to skip at the beginning, default 0.<\/td>\n<\/tr>\n<tr>\n<td>limit<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of required records, default 10.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>List of <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-suscripci\u00f3n\">subscription objects<\/a> for a customer. Sort by creation date in descending order.<\/p>\n<h2 id=\"comisiones\">Fees<\/h2>\n<p>If the customer accounts were created to handle their own balance, a fee can be charged which will be shown in the Merchant account.<\/p>\n<h2 id=\"cobrar-comisi-n\">Charging a Fee<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>POST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/fees\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/fees \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{                                            \r\n     \"customer_id\" : \"dvocf97jd20es3tw5laz\",\r\n     \"amount\" : 12.50,          \r\n     \"description\" : \"Cobro de Comisi\u00f3n\",\r\n     \"order_id\" : \"oid-1245\"\r\n}' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"amount\":12.50,\r\n   \"authorization\":null,\r\n   \"method\":\"customer\",\r\n   \"operation_type\":\"out\",\r\n   \"currency\":\"MXN\",\r\n   \"transaction_type\":\"fee\",\r\n   \"status\":\"completed\",\r\n   \"id\":\"th8tafyrkakdbyry3kxi\",\r\n   \"creation_date\":\"2013-11-18T10:33:03-06:00\",\r\n   \"description\":\"Cobro de comisi\u00f3n\",\r\n   \"error_message\":null,\r\n   \"order_id\":\"oid-1245\",\r\n   \"customer_id\":\"dvocf97jd20es3tw5laz\"\r\n}\r\n<\/code><\/pre>\n<p>Charge a fee to the customer account.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>customer_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nThe unique identifier of the customer that you want to charge the fee.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nAmount of charge. Must be an amount greater than zero, with up to two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 250)<br \/>\nA description associated with the fee charge.<\/td>\n<\/tr>\n<tr>\n<td>order_id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 100)<br \/>\nUnique fee identifier. It has to be unique among all the transactions.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"regresa\">Response<\/h3>\n<p>The <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> of the fee including the creation date and id or an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"devolver-comisi-n\">Refund Fee<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>POST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/fees\/{TRANSACTION_ID}\/refund\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/fees\/trzjaozcik8msyqshka4\/refund \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{                                            \r\n     \"description\" : \"Devoluci\u00f3n de Comisi\u00f3n\"\r\n}' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n  \"id\": \"th8tafyrkakdbyry3kxi\",\r\n  \"authorization\": null,\r\n  \"method\": \"customer\",\r\n  \"operation_type\": \"in\",\r\n  \"transaction_type\": \"refund\",\r\n  \"status\": \"completed\",\r\n  \"conciliated\": true,\r\n  \"creation_date\": \"2016-09-06T11:56:57-05:00\",\r\n  \"operation_date\": \"2016-09-06T11:56:57-05:00\",\r\n  \"description\": \"devoluci\u00f3n de comisi\u00f3n merchant03\",\r\n  \"error_message\": null,\r\n  \"order_id\": null,\r\n  \"customer_id\": \"ar2btmquidjhykdaztp6\",\r\n  \"amount\": 11.11,\r\n  \"currency\": \"MXN\"\r\n}\r\n<\/code><\/pre>\n<p>Refund a fee to the customer account.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong> (optional, length = 250)<br \/>\nA description associated with the fee charge.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"regresa\">Response<\/h3>\n<p>The <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction object<\/a> of the refund including the creation date and id or an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a>.<\/p>\n<h2 id=\"listado-de-comisiones\">Fee list<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/fees\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl -g \"https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/fees?limit=10\" \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>[\r\n   {\r\n      \"amount\":30.00,\r\n      \"authorization\":null,\r\n      \"method\":\"customer\",\r\n      \"operation_type\":\"out\",\r\n      \"currency\":\"MXN\",\r\n      \"transaction_type\":\"fee\",\r\n      \"status\":\"completed\",\r\n      \"id\":\"th8tafyrkakdbyry3kxi\",\r\n      \"creation_date\":\"2013-11-18T10:33:03-06:00\",\r\n      \"description\":\"Cobro de comisi\u00f3n\",\r\n      \"error_message\":null,\r\n      \"order_id\":\"oid-1367\",\r\n      \"customer_id\":\"dvocf97jd20es3tw5laz\"\r\n   },\r\n   {\r\n      \"amount\":12.00,\r\n      \"authorization\":null,\r\n      \"method\":\"customer\",\r\n      \"operation_type\":\"out\",\r\n      \"currency\":\"MXN\",\r\n      \"transaction_type\":\"fee\",\r\n      \"status\":\"completed\",\r\n      \"id\":\"tdzottaaohuhosf4cdv9\",\r\n      \"creation_date\":\"2013-11-17T05:35:00-06:00\",\r\n      \"description\":\"Cobro de comisi\u00f3n\",\r\n      \"error_message\":null,\r\n      \"order_id\":\"oid-1366\",\r\n      \"customer_id\":\"afk4csrazjp1udezj1po\"\r\n   }\r\n]\r\n<\/code><\/pre>\n<p>Returns the details of every fee charged by the Merchant.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<p>It can be done using the following parameters:<\/p>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>creation<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nSame as creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[gte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nAfter the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>creation[lte]<\/td>\n<td><strong><em>date<\/em><\/strong><br \/>\nBefore the creation date. Format yyyy-mm-dd<\/td>\n<\/tr>\n<tr>\n<td>offset<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of records to skip at the beginning, default 0.<\/td>\n<\/tr>\n<tr>\n<td>limit<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nNumber of required records, default 10.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns an array of <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-transacci-n\">transaction objects<\/a> for the charged fees in descending order, each one with the identifier of the customer to whom it was made.<\/p>\n<h2 id=\"webhooks\">Webhooks<\/h2>\n<p>Weebhooks allow to notify a Merchant party when an event has occurred in the platform, so the Merchant can take the corresponding actions.<\/p>\n<h2 id=\"objeto-webhook\">Webhook Object<\/h2>\n<blockquote><p>Object example<\/p><\/blockquote>\n<pre><code>  {\r\n    \"id\" : \"wxvanstudf4ssme8khmc\",\r\n    \"url\" : \"http:\/\/requestb.in\/11vxrsf1\",\r\n    \"user\" : \"juanito\",\r\n    \"password\" : \"passjuanito\",\r\n    \"event_types\" : [\r\n      \"charge.refunded\",\r\n      \"charge.failed\",\r\n      \"charge.cancelled\",\r\n      \"charge.created\",\r\n      \"chargeback.accepted\"\r\n    ],\r\n    \"status\":\"verified\"\r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nUnique webhook identifier number.<\/td>\n<\/tr>\n<tr>\n<td>url<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nWebhook<\/td>\n<\/tr>\n<tr>\n<td>user<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nUser name used for webhook\u2019s basic authentication.<\/td>\n<\/tr>\n<tr>\n<td>password<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nPassword for webhook\u2019s basic authentication.<\/td>\n<\/tr>\n<tr>\n<td>event_types<\/td>\n<td><strong><em>array[string]<\/em><\/strong><br \/>\nList of events where the webhook will be triggered.<\/td>\n<\/tr>\n<tr>\n<td>status<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nWebhook status, it indicates if it\u2019s verified or not (unverified).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<table>\n<thead>\n<tr>\n<th>Event<\/th>\n<th>Category<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>charge.refunded<\/td>\n<td>Charges<\/td>\n<td>Reports when there is a charge refund.<\/td>\n<\/tr>\n<tr>\n<td>charge.failed<\/td>\n<td>Charges<\/td>\n<td>Reports when a charge failed and it wasn\u2019t applied.<\/td>\n<\/tr>\n<tr>\n<td>charge.cancelled<\/td>\n<td>Charges<\/td>\n<td>Reports when a charge is cancelled.<\/td>\n<\/tr>\n<tr>\n<td>charge.created<\/td>\n<td>Charges<\/td>\n<td>Reports when a charge is scheduled.<\/td>\n<\/tr>\n<tr>\n<td>charge.succeeded<\/td>\n<td>Charges<\/td>\n<td>Reports when a charge is applied.<\/td>\n<\/tr>\n<tr>\n<td>charge.rescored.to.decline<\/td>\n<td>Charges<\/td>\n<td>Reports when a charge\u2019 score is recalculated and is declined.<\/td>\n<\/tr>\n<tr>\n<td>subscription.charge.failed<\/td>\n<td>Suscripci\u00f3n<\/td>\n<td>Reports when the charge to a subscription fails.<\/td>\n<\/tr>\n<tr>\n<td>payout.created<\/td>\n<td>Payments<\/td>\n<td>Reports when a payout has been scheduled for the next day.<\/td>\n<\/tr>\n<tr>\n<td>payout.succeeded<\/td>\n<td>Payments<\/td>\n<td>Reports when a payout has been applied.<\/td>\n<\/tr>\n<tr>\n<td>payout.failed<\/td>\n<td>Payments<\/td>\n<td>Reports when a payout has failed.<\/td>\n<\/tr>\n<tr>\n<td>transfer.succeeded<\/td>\n<td>Wire transfers<\/td>\n<td>Reports when a transfer has been performed between to Openpay accounts.<\/td>\n<\/tr>\n<tr>\n<td>fee.succeeded<\/td>\n<td>Fees<\/td>\n<td>Reports when a fee is charged successfully to a customer.<\/td>\n<\/tr>\n<tr>\n<td>fee.refund.succeeded<\/td>\n<td>Fees<\/td>\n<td>Reports when a fee has been successfully refunded to a customer.<\/td>\n<\/tr>\n<tr>\n<td>spei.received<\/td>\n<td>SPEI<\/td>\n<td>Reports when a payout has been received by SPEI for adding funds to the account.<\/td>\n<\/tr>\n<tr>\n<td>chargeback.created<\/td>\n<td>Chargebacks<\/td>\n<td>Reports when a chargeback of a transaction was receive and a transaction has been initiated.<\/td>\n<\/tr>\n<tr>\n<td>chargeback.rejected<\/td>\n<td>Chargebacks<\/td>\n<td>Reports when a chargeback has been rejected.<\/td>\n<\/tr>\n<tr>\n<td>chargeback.accepted<\/td>\n<td>Chargebacks<\/td>\n<td>Reports when a chargeback has been accepted.<\/td>\n<\/tr>\n<tr>\n<td>order.created<\/td>\n<td>Order<\/td>\n<td>Reports when an order is created an scheduled.<\/td>\n<\/tr>\n<tr>\n<td>order.activated<\/td>\n<td>Order<\/td>\n<td>Reports when an order is activated.<\/td>\n<\/tr>\n<tr>\n<td>order.payment.received<\/td>\n<td>Order<\/td>\n<td>Reports when an order is received.<\/td>\n<\/tr>\n<tr>\n<td>order.completed<\/td>\n<td>Order<\/td>\n<td>Reports when an order is completed.<\/td>\n<\/tr>\n<tr>\n<td>order.expired<\/td>\n<td>Order<\/td>\n<td>Reports when an order has expired.<\/td>\n<\/tr>\n<tr>\n<td>order.cancelled<\/td>\n<td>Order<\/td>\n<td>Reports when an order is canceled.<\/td>\n<\/tr>\n<tr>\n<td>order.payment.cancelled<\/td>\n<td>Order<\/td>\n<td>Reports when a payment order is canceled.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"caracter-sticas-de-un-servicio-webhook-v-lido\">Valid Webhook service features<\/h2>\n<ul>\n<li>Endpoint: Domains only (No IPs). example: https:\/\/notifications.merchant.com<\/li>\n<li>Port: 443\/TCP, 1518\/TCP, 1519\/TCP, 8443\/TCP y 10443\/TCP<\/li>\n<li>Protocol: HTTPS\/TLS_1.2<\/li>\n<li>Certificate: Valid (Signed by public CA and match with domain).<\/li>\n<\/ul>\n<h2 id=\"crear-un-webhook\">Webhook Creation<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>POST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/webhooks\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/webhooks \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n    \"url\" : \"http:\/\/requestb.in\/11vxrsf1\",\r\n    \"user\" : \"juanito\",\r\n    \"password\" : \"passjuanito\",\r\n    \"event_types\" : [\r\n      \"charge.refunded\",\r\n      \"charge.failed\",\r\n      \"charge.cancelled\",\r\n      \"charge.created\",\r\n      \"chargeback.accepted\"\r\n    ]\r\n}'\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n  \"id\" : \"wkn0t30zfxpmhr5usgfa\",\r\n  \"url\" : \"http:\/\/requestb.in\/qt3bq0qt\",\r\n  \"user\" : \"juanito\",\r\n  \"event_types\" : [\r\n    \"charge.succeeded\",\r\n    \"charge.created\",\r\n    \"charge.cancelled\",\r\n    \"charge.failed\"\r\n  ],\r\n  \"status\" : \"verified\"\r\n}\r\n<\/code><\/pre>\n<p>When you save webhooks an ID will be generated that can be used to eliminate it or simply get not sensitive webhook information.<\/p>\n<p>At the time of saving the webhook, an id will be generated that can be used to eliminate or simply obtain the non-sensitive information from the webhook.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>url<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nWebhook<\/td>\n<\/tr>\n<tr>\n<td>user<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nUser name used for webhook\u2019s basic authentication.<\/td>\n<\/tr>\n<tr>\n<td>password<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nPassword for webhook\u2019s basic authentication.<\/td>\n<\/tr>\n<tr>\n<td>event_types<\/td>\n<td><strong><em>array[string]<\/em><\/strong><br \/>\nList of events where the webhook will be triggered.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-webhook\">webhook object<\/a> when it was successfully created or an error response if there was an error on creation.<\/p>\n<h2 id=\"obtener-un-webhook\">Get a Webhook<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/webhooks\/{WEBHOOK_ID}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/webhooks\/wxvanstudf4ssme8khmc \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\"\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>  {\r\n    \"id\" : \"wxvanstudf4ssme8khmc\",\r\n    \"url\" : \"http:\/\/requestb.in\/11vxrsf1\",\r\n    \"user\" : \"juanito\",\r\n    \"event_types\" : [\r\n      \"verification\",\r\n      \"charge.refunded\",\r\n      \"charge.failed\",\r\n      \"charge.cancelled\",\r\n      \"charge.created\",\r\n      \"charge.succeeded\",\r\n      \"subscription.charge.failed\",\r\n      \"payout.created\",\r\n      \"payout.succeeded\",\r\n      \"payout.failed\",\r\n      \"transfer.succeeded\",\r\n      \"fee.succeeded\",\r\n      \"spei.received\",\r\n      \"chargeback.created\",\r\n      \"chargeback.rejected\",\r\n      \"chargeback.accepted\"\r\n    ],\r\n    \"status\" : \"verified\"\r\n  }\r\n<\/code><\/pre>\n<p>Get a list of the webhook details by ID.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nUnique webhook identifier<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-webhook\">webhook object<\/a><\/p>\n<h2 id=\"eliminar-un-webhook\">Delete a Webhook<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>DELETE https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/webhooks\/{WEBHOOK_ID}\r\n<\/code><\/pre>\n<blockquote><p>Customer request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/webhooks\/wxvanstudf4ssme8khmc \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -X DELETE\r\n<\/code><\/pre>\n<p>Delete a webhook from the merchant.<\/p>\n<p>To delete a webhook you only need to provide the ID.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nUnique webhook identifier<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>If the webhook was deleted correctly the response will be empty, if the webhook cannot be deleted an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error object<\/a> explaining the reason.<\/p>\n<h2 id=\"listado-de-webhook\">Webhook list<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/webhooks\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/webhooks \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\"\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>[\r\n  {\r\n    \"id\" : \"wDashboard185\",\r\n    \"event_types\" : [\r\n      \"verification\",\r\n      \"charge.refunded\",\r\n      \"charge.failed\",\r\n      \"charge.cancelled\",\r\n      \"charge.created\",\r\n      \"charge.succeeded\",\r\n      \"subscription.charge.failed\",\r\n      \"payout.created\",\r\n      \"payout.succeeded\",\r\n      \"payout.failed\",\r\n      \"transfer.succeeded\",\r\n      \"fee.succeeded\",\r\n      \"spei.received\",\r\n      \"chargeback.created\",\r\n      \"chargeback.rejected\",\r\n      \"chargeback.accepted\"\r\n    ],\r\n    \"url\" : \"http:\/\/requestb.in\/11vxrsf1\",\r\n    \"status\" : \"verified\"\r\n  },\r\n  {\r\n    \"id\" : \"wDashboard186\",\r\n    \"event_types\" : [\r\n      \"verification\",\r\n      \"charge.refunded\",\r\n      \"charge.failed\",\r\n      \"charge.cancelled\",\r\n      \"charge.created\",\r\n      \"charge.succeeded\",\r\n      \"subscription.charge.failed\"\r\n    ],\r\n    \"url\" : \"http:\/\/requestb.in\/1fhpiog1\",\r\n    \"status\" : \"verified\"\r\n  }\r\n]\r\n<\/code><\/pre>\n<p>Returns a list registered by the merchant.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>The list of <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-webhook\">webhook object<\/a> registered according to the given parameters.<\/p>\n<h2 id=\"tokens\">Tokens<\/h2>\n<p>The objective is to created tokens from the user browser or device to capture the card information so this doesn\u2019t go through your server and you can avoid or reduce the PCI certification process.<\/p>\n<p>To use this API functionality we recommend using our JavaScript library for your Web application and our Android and iOS SDK for mobile apps.<\/p>\n<p><strong>Features<\/strong><\/p>\n<ul>\n<li>Tokens are created at Merchant level.<\/li>\n<li>Tokens are not link to any customer.<\/li>\n<li>After a token has been created it can only be use once to make a charge.<\/li>\n<\/ul>\n<h2 id=\"objeto-token\">Token Object<\/h2>\n<blockquote><p>Object example<\/p><\/blockquote>\n<pre><code>{\r\n      \"id\":\"tokfa4swch8gr4icy2ma\",\r\n      \"card\":{\r\n         \"card_number\":\"1111\",\r\n         \"holder_name\":\"Juan Perez Ramirez\",\r\n         \"expiration_year\":\"20\",\r\n         \"expiration_month\":\"04\",\r\n         \"address\":{\r\n            \"line1\":\"Av 5 de febrero\",\r\n            \"line2\":\"Roble 207\",\r\n            \"line3\":\"Queretaro\",\r\n            \"state\":\"Queretaro\",\r\n            \"city\":\"Queretaro\",\r\n            \"postal_code\":\"76900\",\r\n            \"country_code\":\"MX\"\r\n         },\r\n         \"creation_date\":\"2014-01-30T13:53:11-06:00\",\r\n         \"brand\":\"visa\",\r\n         \"points_card\":false\r\n      }\r\n   }\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nToken identifier. This is the ID that you should use to perform operations.<\/td>\n<\/tr>\n<tr>\n<td>card<\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nCard associated with the token. See <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-tarjeta\">card object<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"crear-un-nuevo-token\">Create a new token<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>POST https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/tokens\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/tokens \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab: \r\n   -H \"Content-type: application\/json\" \r\n   -X POST -d '{\r\n   \"card_number\":\"4111111111111111\",\r\n   \"holder_name\":\"Juan Perez Ramirez\",\r\n   \"expiration_year\":\"20\",\r\n   \"expiration_month\":\"12\",\r\n   \"cvv2\":\"110\",\r\n   \"address\":{\r\n      \"city\":\"Quer\u00e9taro\",\r\n      \"country_code\":\"MX\",\r\n      \"postal_code\":\"76900\",\r\n      \"line1\":\"Av 5 de Febrero\",\r\n      \"line2\":\"Roble 207\",\r\n      \"line3\":\"col carrillo\",\r\n      \"state\":\"Queretaro\"\r\n   }\r\n}' \r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"k1n0mscnjwhxqia8q7cm\",\r\n   \"card\":{\r\n      \"card_number\":\"411111XXXXXX1111\",\r\n      \"holder_name\":\"Juan Perez Ramirez\",\r\n      \"expiration_year\":\"20\",\r\n      \"expiration_month\":\"12\",\r\n      \"address\":{\r\n         \"line1\":\"Av 5 de Febrero\",\r\n         \"line2\":\"Roble 207\",\r\n         \"line3\":\"col carrillo\",\r\n         \"state\":\"Queretaro\",\r\n         \"city\":\"Quer\u00e9taro\",\r\n         \"postal_code\":\"76900\",\r\n         \"country_code\":\"MX\"\r\n      },\r\n      \"creation_date\":null,\r\n      \"brand\":\"visa\"\r\n   }\r\n}\r\n<\/code><\/pre>\n<p>To create a token using Openpay you need to send the object with the info that will be stored. Once the token it\u2019s stored, you can\u2019t get the number and secutirty code because this information is encrypted.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>holder_name<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nName of the cardholder.<\/td>\n<\/tr>\n<tr>\n<td>card_number<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nCard Number, it can be 16 or 19 digits.<\/td>\n<\/tr>\n<tr>\n<td>cvv2<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nSecurity code as it appears on the back of the card. Usually 3 digits.<\/td>\n<\/tr>\n<tr>\n<td>expiration_month<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nExpiration month as it appears on the card.<\/td>\n<\/tr>\n<tr>\n<td>expiration_year<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nExpiration year as it appears on the card.<\/td>\n<\/tr>\n<tr>\n<td>address<\/td>\n<td><strong><em>object<\/em><\/strong> (optional)<br \/>\nBilling address of cardholder.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"repuesta\">Repuesta<\/h3>\n<p>Returns the created <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-token\">token object<\/a> or an <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-error\">error response.<\/a> if an error occurred during the creation.<\/p>\n<h2 id=\"obtener-un-token\">Get a Token<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\/tokens\/{TOKEN_ID}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f\/tokens\/k1n0mscnjwhxqia8q7cm \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"k1n0mscnjwhxqia8q7cm\",\r\n   \"card\":{\r\n      \"card_number\":\"411111XXXXXX1111\",\r\n      \"holder_name\":\"Juan Perez Ramirez\",\r\n      \"expiration_year\":\"20\",\r\n      \"expiration_month\":\"12\",\r\n      \"address\":{\r\n         \"line1\":\"Av 5 de Febrero\",\r\n         \"line2\":\"Roble 207\",\r\n         \"line3\":\"col carrillo\",\r\n         \"state\":\"Queretaro\",\r\n         \"city\":\"Quer\u00e9taro\",\r\n         \"postal_code\":\"76900\",\r\n         \"country_code\":\"MX\"\r\n      },\r\n      \"creation_date\":null,\r\n      \"brand\":\"visa\"\r\n   }\r\n}\r\n<\/code><\/pre>\n<p>Gets the token details. The ID is required.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nToken ID<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>Returns a <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-token\">token object<\/a><\/p>\n<h2 id=\"comercio\">Merchant<\/h2>\n<p>The merchant object allows you to query info related to your account using the API,<\/p>\n<h2 id=\"objeto-comercio\">Merchant Object<\/h2>\n<blockquote><p>Object example:<\/p><\/blockquote>\n<pre><code>{ \r\n   \"id\": \"m9lrykwsmljagrfb38rs\", \r\n   \"creationDate\": \"2013-11-13T16:58:40-06:00\", \r\n   \"name\": \"Promociones en linea\", \r\n   \"email\": \"contacto@enlinea.com.mx\", \r\n   \"phone\": \"(321) 222-2222\", \r\n   \"status\": \"active\", \r\n   \"balance\": 1000, \r\n   \"clabe\": \"646180109400000542\" \r\n} \r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nUnique identifier assigned on creation.<\/td>\n<\/tr>\n<tr>\n<td>creation_date<\/td>\n<td><strong><em>datetime<\/em><\/strong><br \/>\nCreation date of the transaction in format ISO 8601.<\/td>\n<\/tr>\n<tr>\n<td>name<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nRegistered merchant name.<\/td>\n<\/tr>\n<tr>\n<td>email<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nEmail account registered for the merchant.<\/td>\n<\/tr>\n<tr>\n<td>phone<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nPhone number registered for the merchant.<\/td>\n<\/tr>\n<tr>\n<td>status<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nMerchant account status, it can be active or deleted. If the account is in deletate status no transactions are allowed.<\/td>\n<\/tr>\n<tr>\n<td>balance<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nAccount balance with two decimal digits.<\/td>\n<\/tr>\n<tr>\n<td>clabe<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nLinked CLABE account where funds can be received from any bank in Mexico using SPEI.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"obtener-un-comercio\">Request a Merchant Object<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/sandbox-api.openpay.mx\/v1\/{MERCHANT_ID}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/sandbox-api.openpay.mx\/v1\/mzdtln0bmtms6o3kck8f \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>{\r\n   \"name\":\"Demo Openpay\",\r\n   \"email\":\"demo@openpay.mx\",\r\n   \"phone\":\"(442) 258-1039\",\r\n   \"status\":\"active\",\r\n   \"balance\":218.73,\r\n   \"clabe\":\"646180109400135624\",\r\n   \"id\":\"mzdtln0bmtms6o3kck8f\",\r\n   \"creation_date\":\"2014-01-23T10:45:53-06:00\"\r\n}\r\n<\/code><\/pre>\n<p>Returns the merchant account details. Only the unique merchant identifier is required.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong> (required, length = 45)<br \/>\nunique merchant identifier.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>If the identifier is correct it will return a merchant object.<\/p>\n<h2 id=\"tiendas\">Stores<\/h2>\n<p>The object represents a convenience store<\/p>\n<h2 id=\"objeto-tienda\">Store object<\/h2>\n<blockquote><p>Object example:<\/p><\/blockquote>\n<pre><code>{\r\n    \"id_store\": 4913,\r\n    \"id\": 115,\r\n    \"name\": \"0503 SAN PABLO -QRO\",\r\n    \"last_update\": \"2016-02-04T00:52:16-06:00\",\r\n    \"status\": \"active\",\r\n    \"geolocation\": {\r\n      \"lng\": -100.421865,\r\n      \"lat\": 20.618171,\r\n      \"place_id\": \"ChIJwSN2wpNa04URsDryLW517lg\"\r\n    },\r\n    \"address\": {\r\n      \"line1\": \"AV. 5 DE FEBRERO KM 7.5 NO 1341\",\r\n      \"line2\": \"SAN PABLO\",\r\n      \"line3\": null,\r\n      \"state\": \"QUERETARO\",\r\n      \"city\": \"QUERETARO\",\r\n      \"postal_code\": \"76030\",\r\n      \"country_code\": \"MX\"\r\n    },\r\n    \"paynet_chain\": {\r\n      \"name\": \"EXTRA\",\r\n      \"logo\": \"http:\/\/www.openpay.mx\/logotipos\/extra.png\",\r\n      \"thumb\": \"http:\/\/www.openpay.mx\/thumb\/extra.png\",\r\n      \"max_amount\": 99999.99\r\n    }\r\n  }\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id_store<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nUnique identifier assigned on creation.<\/td>\n<\/tr>\n<tr>\n<td>id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nUnique identifier by chain.<\/td>\n<\/tr>\n<tr>\n<td>name<\/td>\n<td><strong><em>datetime<\/em><\/strong><br \/>\nStore name.<\/td>\n<\/tr>\n<tr>\n<td>last_update<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nLast date of update in format ISO 8601.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-geolocation\">geolocation<\/a><\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nStore geographical representation by coordinates, latitude and longitude.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-direcci-n\">address<\/a><\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nStore address.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-paynetchain\">paynet_chain<\/a><\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nPaynet chain to which it belongs.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"obtener-lista-de-tiendas-por-ubicaci-n\">Get list of shops by location<\/h2>\n<blockquote><p>Definition<\/p><\/blockquote>\n<pre><code>GET https:\/\/api.openpay.mx\/stores?latitud={latitud}&amp;longitud={longitud}&amp;kilometers={radio}&amp;amount={monto}\r\n<\/code><\/pre>\n<blockquote><p>Request example<\/p><\/blockquote>\n<pre><code>curl https:\/\/api.openpay.mx\/stores?latitud=20.618975&amp;longitud=-100.422290&amp;kilometers=1.5&amp;amount=4000 \r\n   -u sk_e568c42a6c384b7ab02cd47d2e407cab:\r\n<\/code><\/pre>\n<blockquote><p>Response example<\/p><\/blockquote>\n<pre><code>[\r\n  {\r\n    \"id_store\": 4913,\r\n    \"id\": 115,\r\n    \"name\": \"0503 SAN PABLO -QRO\",\r\n    \"last_update\": \"2016-02-04T00:52:16-06:00\",\r\n    \"status\": \"active\",\r\n    \"geolocation\": {\r\n      \"lng\": -100.421865,\r\n      \"lat\": 20.618171,\r\n      \"place_id\": \"ChIJwSN2wpNa04URsDryLW517lg\"\r\n    },\r\n    \"address\": {\r\n      \"line1\": \"AV. 5 DE FEBRERO KM 7.5 NO 1341\",\r\n      \"line2\": \"SAN PABLO\",\r\n      \"line3\": null,\r\n      \"state\": \"QUERETARO\",\r\n      \"city\": \"QUERETARO\",\r\n      \"postal_code\": \"76030\",\r\n      \"country_code\": \"MX\"\r\n    },\r\n    \"paynet_chain\": {\r\n      \"name\": \"EXTRA\",\r\n      \"logo\": \"http:\/\/www.openpay.mx\/logotipos\/extra.png\",\r\n      \"thumb\": \"http:\/\/www.openpay.mx\/thumb\/extra.png\",\r\n      \"max_amount\": 99999.99\r\n    }\r\n  },\r\n  {\r\n    \"id_store\": 4726,\r\n    \"id\": 68,\r\n    \"name\": \"ASTURIANO TECNOLOGICO\",\r\n    \"last_update\": \"2016-02-04T00:52:16-06:00\",\r\n    \"status\": \"active\",\r\n    \"geolocation\": {\r\n      \"lng\": -100.410136,\r\n      \"lat\": 20.61632,\r\n      \"place_id\": \"EktQcm9sIFRlY25vbMOzZ2ljbyBOdGUgOTk5LCBTYW4gUGFibG8sIFNhbnRpYWdvIGRlIFF1ZXLDqXRhcm8sIFFyby4sIE3DqXhpY28\"\r\n    },\r\n    \"address\": {\r\n      \"line1\": \"PROLONGACION TECNOLOGICO NORTE #999\",\r\n      \"line2\": \"SAN PABLO\",\r\n      \"line3\": null,\r\n      \"state\": \"QUERETARO\",\r\n      \"city\": \"QUERETARO\",\r\n      \"postal_code\": \"76159\",\r\n      \"country_code\": \"MX\"\r\n    },\r\n    \"paynet_chain\": {\r\n      \"name\": \"EL ASTURIANO\",\r\n      \"logo\": \"http:\/\/www.openpay.mx\/logotipos\/asturiano.png\",\r\n      \"thumb\": \"http:\/\/www.openpay.mx\/thumb\/asturiano.png\",\r\n      \"max_amount\": 99999.99\r\n    }\r\n  }\r\n]\r\n<\/code><\/pre>\n<p>Gets the trade account details. Only it required to indicate the unique id of trade to be obtained.<\/p>\n<h3 id=\"petici-n\">Request<\/h3>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>latitud<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nLatitude of geographical location Store<\/td>\n<\/tr>\n<tr>\n<td>longitud<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nLongitud of geographical location Store<\/td>\n<\/tr>\n<tr>\n<td>kilometers<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nRadius distance in kilometers search<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong> (required)<br \/>\nPurchase amount<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"respuesta\">Response<\/h3>\n<p>If there are stores close range a settlement with stores found it is returned.<\/p>\n<h2 id=\"objetos-comunes\">Common Objects<\/h2>\n<p>Information for objects shared in request and response.<\/p>\n<h2 id=\"objeto-transacci-n\">Transaction Object<\/h2>\n<blockquote><p>Object example:<\/p><\/blockquote>\n<pre><code>{\r\n   \"id\":\"trehwr2zarltvae56vxl\",\r\n   \"authorization\":null,\r\n   \"transaction_type\":\"payout\",\r\n   \"operation_type\":\"out\",\r\n   \"currency\":\"MXN\",\r\n   \"method\":\"bank\",\r\n   \"creation_date\":\"2013-11-14T18:29:35-06:00\",\r\n   \"order_id\":\"000001\",\r\n   \"status\":\"in_progress\",\r\n   \"amount\":500,\r\n   \"description\":\"Pago de ganancias\",\r\n   \"error_message\":null,\r\n   \"customer_id\":\"afk4csrazjp1udezj1po\",\r\n   \"bank_account\":{\r\n      \"rfc\":ONE316015PM1,\r\n      \"mobile\":null,\r\n      \"alias\":null,\r\n      \"bank_name\":\"BANCOMER\",\r\n      \"creation_date\":\"2013-11-14T18:29:34-06:00\",\r\n      \"clabe\":\"012XXXXXXXXXX24616\",\r\n      \"holder_name\":\"Juan Tapia Trejo\",\r\n      \"bank_code\":\"012\"\r\n   }\r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id<\/td>\n<td><em><strong>string<\/strong><\/em><br \/>\nUnique identifier assigned by Openpay at the moment of creation.<\/td>\n<\/tr>\n<tr>\n<td>authorization<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nAuthorization number created by the processor entity.<\/td>\n<\/tr>\n<tr>\n<td>transaction_type<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nTransaction type: fee, charge, payout, transfer.<\/td>\n<\/tr>\n<tr>\n<td>operation_type<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nOperation type in the account: in, out.<\/td>\n<\/tr>\n<tr>\n<td>method<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nTransaction method type: card, bank o customer.<\/td>\n<\/tr>\n<tr>\n<td>creation_date<\/td>\n<td><strong><em>datetime<\/em><\/strong><br \/>\nCreation date of the transaction in format ISO 8601.<\/td>\n<\/tr>\n<tr>\n<td>order_id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nUnique transaction and reference number.<\/td>\n<\/tr>\n<tr>\n<td>status<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nCurrent transaction status. Possible values: completed, in_progress, failed.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nTransaction full amount, including two decimal places.<\/td>\n<\/tr>\n<tr>\n<td>description<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nTransaction description.<\/td>\n<\/tr>\n<tr>\n<td>error_message<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nIf the transaction is in failed status, this field will include the error message.<\/td>\n<\/tr>\n<tr>\n<td>customer_id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nUnique identifier for the customer who this transaction belongs. If the value is null the transaction belongs to Merchant account.<\/td>\n<\/tr>\n<tr>\n<td>currency<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nCurrency used in the operation by default is MXN (Mexican pesos).<\/td>\n<\/tr>\n<tr>\n<td>bank_account<\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nBank account data used for the transaction. See the BankAccount object.<\/td>\n<\/tr>\n<tr>\n<td>card<\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nCredit card data used in the transaction. See the Card object.<\/td>\n<\/tr>\n<tr>\n<td>card_points<\/td>\n<td><strong><em>object<\/em><\/strong><br \/>\nContains information about the reward points used for payment, if they were used. See the <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-cardpoints\">CardPoints object<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-direcci-n\">Address Object<\/h2>\n<blockquote><p>Object example:<\/p><\/blockquote>\n<pre><code>{\r\n   \"line1\":\"Av 5 de Febrero\",\r\n   \"line2\":\"Roble 207\",\r\n   \"line3\":\"col carrillo\",\r\n   \"state\":\"Queretaro\",\r\n   \"city\":\"Quer\u00e9taro\",\r\n   \"postal_code\":\"76900\",\r\n   \"country_code\":\"MX\" \r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>line1<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nThe first line is the card owner address. It\u2019s commonly used to indicate street address and number.<\/td>\n<\/tr>\n<tr>\n<td>line2<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nSecond addres line, commonly use to indicate interior number, suite number or county.<\/td>\n<\/tr>\n<tr>\n<td>line3<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nThird address line, commonly use to to indicate the neighborhood.<\/td>\n<\/tr>\n<tr>\n<td>postal_code<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nZip code<\/td>\n<\/tr>\n<tr>\n<td>state<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nState<\/td>\n<\/tr>\n<tr>\n<td>city<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nCity<\/td>\n<\/tr>\n<tr>\n<td>country_code<\/td>\n<td><strong><em>string<\/em><\/strong> (required)<br \/>\nCountry code, in the two character format: ISO_3166-1.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-store\">Store object<\/h2>\n<blockquote><p>Object example:<\/p><\/blockquote>\n<pre><code>{\r\n   \"reference\":\"OPENPAY02DQ35YOY7\",\r\n   \"barcode_url\":\"https:\/\/sandbox-api.openpay.mx\/barcode\/OPENPAY02DQ35YOY7?width=1&amp;height=45&amp;text=false\",\r\n   \"paybin_reference\":\"0101990000001065\",\r\n   \"barcode_paybin_url\":\"https:\/\/sandbox-api.openpay.mx\/barcode\/0101990000001065?width=1&amp;height=45&amp;text=false\"\r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>reference<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nPayment reference to go stores and make deposits to Openpay account<\/td>\n<\/tr>\n<tr>\n<td>barcode_url<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nIt is the url that generates the bar code of reference.<\/td>\n<\/tr>\n<tr>\n<td>paybin_reference<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nPaybin reference to go store and make deposits to Openpay<\/td>\n<\/tr>\n<tr>\n<td>barcode_paybin_url<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nIt is the url that generates the bar code of paybin reference.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-paymentplan\">PaymentPlan Object<\/h2>\n<blockquote><p>Object example:<\/p><\/blockquote>\n<pre><code>{\r\n   \"payments\":\"6\"\r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>payments<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nPlan data months without interest is desired as use in the charge (3, 6, 9, 12, 18).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-cardpoints\">Cardpoints Object<\/h2>\n<blockquote><p>Object example:<\/p><\/blockquote>\n<pre><code>{\r\n    \"used\": 134,\r\n    \"remaining\": 300,\r\n    \"caption\": \"TRANSACCION APROBADA. ME OBLIGO EN LOS TERMINOS Y CONDICIONES DEL PROGRAMA RECOMPENSAS SANTANDER. PARA CUALQUIER DUDA O ACLARACION LLAME AL 01800 RECOMPE (73-266-73).\",\r\n    \"amount\": 10\r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>used<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nAmount of points used in the payment.<\/td>\n<\/tr>\n<tr>\n<td>remaining<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nAmount of points remaining in the card after the payment.<\/td>\n<\/tr>\n<tr>\n<td>amount<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nTransaction amount paid using points.<\/td>\n<\/tr>\n<tr>\n<td>caption<\/td>\n<td><strong><em>string<\/em><\/strong> (optional)<br \/>\nA message to be shown to the customer in their ticket or receipt.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-geolocation\">Object Geolocation<\/h2>\n<blockquote><p>Object example:<\/p><\/blockquote>\n<pre><code>{\r\n  \"lng\": -100.421865,\r\n  \"lat\": 20.618171,\r\n  \"place_id\": \"ChIJwSN2wpNa04URsDryLW517lg\"\r\n}\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>lng<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nLongitud, geographical coordinate.<\/td>\n<\/tr>\n<tr>\n<td>lat<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nLatitud, geographical coordinate.<\/td>\n<\/tr>\n<tr>\n<td>place_id<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nUnique identifier of google maps<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-paynetchain\">Object PaynetChain<\/h2>\n<blockquote><p>Object example:<\/p><\/blockquote>\n<pre><code>{\r\n      \"name\": \"EXTRA\",\r\n      \"logo\": \"http:\/\/www.openpay.mx\/logotipos\/extra.png\",\r\n      \"thumb\": \"http:\/\/www.openpay.mx\/thumb\/extra.png\",\r\n      \"max_amount\": 99999.99\r\n    }\r\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>Property<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>name<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nChain name.<\/td>\n<\/tr>\n<tr>\n<td>logo<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nURL logo image chain.<\/td>\n<\/tr>\n<tr>\n<td>thumb<\/td>\n<td><strong><em>string<\/em><\/strong><br \/>\nURL thumbnail image chain.<\/td>\n<\/tr>\n<tr>\n<td>max_amount<\/td>\n<td><strong><em>numeric<\/em><\/strong><br \/>\nMaximum payment amount that accept chain stores<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-transaction-status\">Object Transaction Status<\/h2>\n<table>\n<thead>\n<tr>\n<th>Value<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>IN_PROGRESS<\/td>\n<td>Transaction is in progress<\/td>\n<\/tr>\n<tr>\n<td>COMPLETED<\/td>\n<td>Transaction was succesfully completed<\/td>\n<\/tr>\n<tr>\n<td>REFUNDED<\/td>\n<td>Transaction that has been refunded<\/td>\n<\/tr>\n<tr>\n<td>CHARGEBACK_PENDING<\/td>\n<td>Transaction that has a pending chargeback<\/td>\n<\/tr>\n<tr>\n<td>CHARGEBACK_ACCEPTED<\/td>\n<td>Transaction that has an accepted chargeback<\/td>\n<\/tr>\n<tr>\n<td>CHARGEBACK_ADJUSTMENT<\/td>\n<td>Transaction that has an ajust for chargeback<\/td>\n<\/tr>\n<tr>\n<td>CHARGE_PENDING<\/td>\n<td>Transaction that is waiting to be paid<\/td>\n<\/tr>\n<tr>\n<td>CANCELLED<\/td>\n<td>Transaction that was not paid and has been cancelled<\/td>\n<\/tr>\n<tr>\n<td>FAILED<\/td>\n<td>Transaction that was paid but ocurred an error<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"facturaci-n-electr-nica\">Electronic Invoice<\/h2>\n<h2 id=\"objeto-generaci-n-de-cfdi\">Generation of CFDI Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>openpay_transaction_id<\/td>\n<td>Optional<br \/>\nId of the transaction in openpay<\/td>\n<\/tr>\n<tr>\n<td>invoice_id<\/td>\n<td>Required<br \/>\nInvoice identifier \/ trade purchase order<\/td>\n<\/tr>\n<tr>\n<td>tipo_comprobante<\/td>\n<td>Optional (default (I) income)<br \/>\n<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-tipo-de-comprobante\">Voucher Type Object<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>serie<\/td>\n<td>Optional (1-25 Alphanumeric)<br \/>\nseries invoice in case of handling<\/td>\n<\/tr>\n<tr>\n<td>folio<\/td>\n<td>Optional payment (1-40 Alphanumeric)<br \/>\nFolio of the invoice in case of handling<\/td>\n<\/tr>\n<tr>\n<td>total<\/td>\n<td>Required (Decimal)<br \/>\nTotal invoice<\/td>\n<\/tr>\n<tr>\n<td>subtotal<\/td>\n<td>Required (Decimal)<br \/>\nSubtotal of the invoice<\/td>\n<\/tr>\n<tr>\n<td>forma_pago<\/td>\n<td>Required<br \/>\nWay to pay<br \/>\nOnly the payment code corresponding to the payment method must be sent.<br \/>\n<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-forma-de-pago\">Form of Payment Object<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>metodo_pago<\/td>\n<td>Required<br \/>\nPayment method<br \/>\n<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-metodo-de-pago\">Payment Method Object<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>lugar_expedicion<\/td>\n<td>Required (5 digits)<br \/>\nPostal Code of the Place of Expedition<\/td>\n<\/tr>\n<tr>\n<td>descuento<\/td>\n<td>Optional (Decimal)<br \/>\nDiscount amount.<\/td>\n<\/tr>\n<tr>\n<td>observaciones<\/td>\n<td>Opcional (Alfanum\u00e9rico)<br \/>\nObservations<\/td>\n<\/tr>\n<tr>\n<td>total_trasladados<\/td>\n<td>Optional (Decimal)<br \/>\nTotal taxes transferred if they exist<\/td>\n<\/tr>\n<tr>\n<td>total_retenidos<\/td>\n<td>Optional (Decimal)<br \/>\nTotal taxes withheld if there are<\/td>\n<\/tr>\n<tr>\n<td>moneda<\/td>\n<td>Required (3 Alphanumeric)<br \/>\nCurrency in which the sale was made in case it is different from MXN. (ISO 4217)<\/td>\n<\/tr>\n<tr>\n<td>tipo_de_cambio<\/td>\n<td>Required (Decimal)<br \/>\nExchange rate of the currency in which the sale was made. 1.00 in case the currency is MXN.<\/td>\n<\/tr>\n<tr>\n<td>receptor<\/td>\n<td>Required (<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-receptor\">Receiver Object<\/a>)<br \/>\nNode that contains the data of the recipient of the invoice<\/td>\n<\/tr>\n<tr>\n<td>conceptos<\/td>\n<td>Required (Arrangement of <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-concepto\">Concept Object<\/a>)<br \/>\nArrangement of concepts included in the invoice<\/td>\n<\/tr>\n<tr>\n<td>cfdi_relacionados<\/td>\n<td>Optional (<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-relacionado\">Objeto Relacionados<\/a>)<br \/>\nRelated invoices<\/td>\n<\/tr>\n<tr>\n<td>complements<\/td>\n<td>Optional (<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-complementos\">Complements Object<\/a>)<br \/>\nComplements<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-tipo-de-comprobante\">Voucher Type Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Tax receipt type<\/th>\n<th>Fiscal Document<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>(I) entry<\/td>\n<td>\n<ul>\n<li>Invoice.<\/li>\n<li>Fee.<\/li>\n<li>Charge note.<\/li>\n<li>Donations.<\/li>\n<li>Lease.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>(E) egress<\/td>\n<td>\n<ul>\n<li>Credit note.<\/li>\n<li>Note of refund.<\/li>\n<li>paysheet.<\/li>\n<li>Assimilables.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>(T) transfer<\/td>\n<td>\n<ul>\n<li>Letter porte.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>(N) paysheet<\/td>\n<td>\n<ul>\n<li>paysheet.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>(P) Payment<\/td>\n<td>\n<ul>\n<li>Payment.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-forma-de-pago\">Form of Payment Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Key<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>01<\/td>\n<td>Cash.<\/td>\n<\/tr>\n<tr>\n<td>02<\/td>\n<td>Cheque nominative.<\/td>\n<\/tr>\n<tr>\n<td>03<\/td>\n<td>Electronic funds transfer.<\/td>\n<\/tr>\n<tr>\n<td>04<\/td>\n<td>Credit card.<\/td>\n<\/tr>\n<tr>\n<td>05<\/td>\n<td>Electronic Wallet.<\/td>\n<\/tr>\n<tr>\n<td>06<\/td>\n<td>Electronic Money.<\/td>\n<\/tr>\n<tr>\n<td>08<\/td>\n<td>Pantry vouchers.<\/td>\n<\/tr>\n<tr>\n<td>12<\/td>\n<td>Dation in payment.<\/td>\n<\/tr>\n<tr>\n<td>13<\/td>\n<td>Payment by subrogation.<\/td>\n<\/tr>\n<tr>\n<td>14<\/td>\n<td>Payment by consignment.<\/td>\n<\/tr>\n<tr>\n<td>15<\/td>\n<td>Condonation.<\/td>\n<\/tr>\n<tr>\n<td>17<\/td>\n<td>Compensation.<\/td>\n<\/tr>\n<tr>\n<td>23<\/td>\n<td>Novation.<\/td>\n<\/tr>\n<tr>\n<td>24<\/td>\n<td>Confusion.<\/td>\n<\/tr>\n<tr>\n<td>25<\/td>\n<td>Debt remittance.<\/td>\n<\/tr>\n<tr>\n<td>26<\/td>\n<td>Prescription or expiration.<\/td>\n<\/tr>\n<tr>\n<td>27<\/td>\n<td>To the satisfaction of the creditor.<\/td>\n<\/tr>\n<tr>\n<td>28<\/td>\n<td>Debit Card.<\/td>\n<\/tr>\n<tr>\n<td>29<\/td>\n<td>Service Card.<\/td>\n<\/tr>\n<tr>\n<td>30<\/td>\n<td>Application of advances.<\/td>\n<\/tr>\n<tr>\n<td>99<\/td>\n<td>Others.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-metodo-de-pago\">Payment Method Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Key<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>PUE<\/td>\n<td>Payment only exhibition<\/td>\n<\/tr>\n<tr>\n<td>PPD<\/td>\n<td>Partial or deferred payments<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-doctorelacionado\">DoctoRelacionado Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Key<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>id_documento<\/td>\n<td>Required (16-36 Alphanumeric)<br \/>\nDocument identifier (uuid).<\/td>\n<\/tr>\n<tr>\n<td>serie<\/td>\n<td>Optional (1-25 Alphanumeric)<br \/>\nDocument series.<\/td>\n<\/tr>\n<tr>\n<td>folio<\/td>\n<td>Optional (1-40 Alphanumeric)<br \/>\nFolio of the document.<\/td>\n<\/tr>\n<tr>\n<td>moneda_d_r<\/td>\n<td>Required (3 Alphabetical)<br \/>\nCurrency Code (ISO 4217).<\/td>\n<\/tr>\n<tr>\n<td>tipo_cambio_d_r<\/td>\n<td>Optional (Decimal)<br \/>\nExchange rate.<\/td>\n<\/tr>\n<tr>\n<td>metodo_de_pago_d_r<\/td>\n<td>Optional<br \/>\nPayment method.<\/td>\n<\/tr>\n<tr>\n<td>num_parcialidad<\/td>\n<td>Optional<br \/>\nPartiality number.<\/td>\n<\/tr>\n<tr>\n<td>imp_saldo_ant<\/td>\n<td>Optional (Decimal)<br \/>\nAmount of the previous balance.<\/td>\n<\/tr>\n<tr>\n<td>imp_pagado<\/td>\n<td>Optional (Decimal)<br \/>\nAmount paid.<\/td>\n<\/tr>\n<tr>\n<td>imp_saldo_insoluto<\/td>\n<td>Optional (Decimal)<br \/>\nAmount of the outstanding balance.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-concepto\">Concept Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Key<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Identificador<\/td>\n<td>Required (1-100 Alphanumeric)<br \/>\nConcept identifier.<\/td>\n<\/tr>\n<tr>\n<td>cantidad<\/td>\n<td>Required (Decimal)<br \/>\nAmount of the concept.<\/td>\n<\/tr>\n<tr>\n<td>unidad<\/td>\n<td>Optional (1-20 Alphanumeric)<br \/>\nUnit of the concept.<\/td>\n<\/tr>\n<tr>\n<td>clave_unidad<\/td>\n<td>Required (Alphanumeric, Key Unit Catalog)<br \/>\nUnit key.<\/td>\n<\/tr>\n<tr>\n<td>descripcion<\/td>\n<td>Required (1-1000 Alphanumeric)<br \/>\nDescription of the concept.<\/td>\n<\/tr>\n<tr>\n<td>valor_unitario<\/td>\n<td>Required (Decimal)<br \/>\nUnit value of the concept.<\/td>\n<\/tr>\n<tr>\n<td>importe<\/td>\n<td>Required (Decimal)<br \/>\nAmount of the transferred tax.<\/td>\n<\/tr>\n<tr>\n<td>clave<\/td>\n<td>Required (1-10 Num\u00e9rico)<br \/>\nKey of the product.<\/td>\n<\/tr>\n<tr>\n<td>descuento<\/td>\n<td>Optional (Decimal)<br \/>\nDiscount amount.<\/td>\n<\/tr>\n<tr>\n<td>traslados<\/td>\n<td>Optional (Arrangement <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-impuesto\">Tax Object<\/a>)<br \/>\nTransfer tax list.<\/td>\n<\/tr>\n<tr>\n<td>retenciones<\/td>\n<td>Optional (Arrangement <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-impuesto\">Tax Object<\/a>)<br \/>\nRetention tax list.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-impuesto\">Tax Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Key<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>impuesto<\/td>\n<td>Required<br \/>\nTax<br \/>\n<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-tipo-de-impuesto\">Tax Type Object<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>tipo_factor<\/td>\n<td>Required<br \/>\nType of factor<br \/>\n<strong><em>Codes:<\/em><\/strong><\/p>\n<ul>\n<li>Rate<\/li>\n<li>Quota<\/li>\n<li>Excento<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>tasa<\/td>\n<td>Required<br \/>\nDecimal<br \/>\nRate that will be used to calculate the tax<\/td>\n<\/tr>\n<tr>\n<td>importe<\/td>\n<td>Required<br \/>\nTax amount calculated<\/td>\n<\/tr>\n<tr>\n<td>base<\/td>\n<td>Optional<br \/>\nAmount on which the Tax will be applied<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-tipo-de-impuesto\">Tax Type Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>001<\/td>\n<td>ISR<\/td>\n<\/tr>\n<tr>\n<td>002<\/td>\n<td>IVA<\/td>\n<\/tr>\n<tr>\n<td>003<\/td>\n<td>IEPS<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-receptor\">Receiver Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>nombre<\/td>\n<td>Required (1-254 Alphanumeric)<br \/>\nName of the recipient of the invoice.<\/td>\n<\/tr>\n<tr>\n<td>rfc<\/td>\n<td>Required<br \/>\nRFC of the invoice recipient.<\/td>\n<\/tr>\n<tr>\n<td>email<\/td>\n<td>Optional<br \/>\nInvoice recipient\u2019s email.<\/td>\n<\/tr>\n<tr>\n<td>residencia_fiscal<\/td>\n<td>Optional<br \/>\nPostal code of the fiscal residence.<\/td>\n<\/tr>\n<tr>\n<td>uso_cfdi<\/td>\n<td>Required (3 Alphanumeric)<br \/>\n<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-uso-de-cfdi\">Object Use of CFDI<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>pais<\/td>\n<td>Optional (3 Alphanumeric)<br \/>\nCountry code (ISO 3166-1 alpha-3). It should not be sent if the RFC is registered with the SAT or is a national generic RFC.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-uso-de-cfdi\">Object Use of CFDI<\/h2>\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>G01<\/td>\n<td>Acquisition of merchandise.<\/td>\n<\/tr>\n<tr>\n<td>G02<\/td>\n<td>Returns, discounts or bonuses.<\/td>\n<\/tr>\n<tr>\n<td>G03<\/td>\n<td>Expenses in general.<\/td>\n<\/tr>\n<tr>\n<td>I01<\/td>\n<td>Buildings.<\/td>\n<\/tr>\n<tr>\n<td>I02<\/td>\n<td>Office furniture and equipment for investments.<\/td>\n<\/tr>\n<tr>\n<td>I03<\/td>\n<td>Transportation equipment.<\/td>\n<\/tr>\n<tr>\n<td>I04<\/td>\n<td>Computer equipment and accessories.<\/td>\n<\/tr>\n<tr>\n<td>I05<\/td>\n<td>Dices, dies, molds, matrices and tooling.<\/td>\n<\/tr>\n<tr>\n<td>I06<\/td>\n<td>Telephone communications.<\/td>\n<\/tr>\n<tr>\n<td>I07<\/td>\n<td>Satellite communications.<\/td>\n<\/tr>\n<tr>\n<td>I08<\/td>\n<td>Other machinery and equipment.<\/td>\n<\/tr>\n<tr>\n<td>D01<\/td>\n<td>Medical and dental fees and hospital expenses.<\/td>\n<\/tr>\n<tr>\n<td>D02<\/td>\n<td>Medical expenses due to disability or disability.<\/td>\n<\/tr>\n<tr>\n<td>D03<\/td>\n<td>Funeral expenses.<\/td>\n<\/tr>\n<tr>\n<td>D04<\/td>\n<td>Donations.<\/td>\n<\/tr>\n<tr>\n<td>D05<\/td>\n<td>Real interest actually paid for mortgage credits (house room).<\/td>\n<\/tr>\n<tr>\n<td>D06<\/td>\n<td>Voluntary contributions to SAR.<\/td>\n<\/tr>\n<tr>\n<td>D07<\/td>\n<td>Premiums for medical expenses insurance.<\/td>\n<\/tr>\n<tr>\n<td>D08<\/td>\n<td>Mandatory school transportation expenses.<\/td>\n<\/tr>\n<tr>\n<td>D09<\/td>\n<td>Deposits in accounts for savings, premiums based on pension plans.<\/td>\n<\/tr>\n<tr>\n<td>D10<\/td>\n<td>Payments for educational services (tuition fees).<\/td>\n<\/tr>\n<tr>\n<td>P01<\/td>\n<td>To define.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-relacionado\">Related Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>tipo_relacion<\/td>\n<td>Required<br \/>\nType relationship<br \/>\n<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-tipo-de-relaci-n\">Object Type of Relationship<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>relacionados<\/td>\n<td>Required (Object arrangement CfdiRelacionado)<br \/>\n<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-cfdi-relacionado\">CFDI Object Related<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-tipo-de-relaci-n\">Object Type of Relationship<\/h2>\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>01<\/td>\n<td>Credit note of related documents.<\/td>\n<\/tr>\n<tr>\n<td>02<\/td>\n<td>Debit note of related documents.<\/td>\n<\/tr>\n<tr>\n<td>03<\/td>\n<td>Return of merchandise on previous invoices or transfers.<\/td>\n<\/tr>\n<tr>\n<td>04<\/td>\n<td>Replacement of previous CFDIs.<\/td>\n<\/tr>\n<tr>\n<td>05<\/td>\n<td>Goods transfers previously invoiced.<\/td>\n<\/tr>\n<tr>\n<td>06<\/td>\n<td>Invoice generated by previous transfers.<\/td>\n<\/tr>\n<tr>\n<td>07<\/td>\n<td>CFDI by advance payment.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-cfdi-relacionado\">CFDI Object Related<\/h2>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>uuid<\/td>\n<td>Required (36 Alphanumeric)<br \/>\nUUID of the related invoice<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-complementos\">Complements Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>aerolineas<\/td>\n<td>Optional (<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-complemento-aerol-neas\">Complement Airlines Object<\/a>)<br \/>\nComplement for Airline.<\/td>\n<\/tr>\n<tr>\n<td>payouts<\/td>\n<td>Optional (<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-complemento-pago\">Complement Payment Object<\/a>)<br \/>\nComplement of payments.<\/td>\n<\/tr>\n<tr>\n<td>donatarias<\/td>\n<td>Optional (<a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-complemento-donatarias\">Complement Donee Object<\/a>)<br \/>\nComplement of donee.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-complemento-aerol-neas\">Complement Airlines Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>tua<\/td>\n<td>Required (Decimal)<br \/>\nAirport use fee<\/td>\n<\/tr>\n<tr>\n<td>otrosCargos<\/td>\n<td>Optional (Arrangement <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-aerol-neas-cargo\">Charge Airlines Object<\/a>)<br \/>\nComplement of payments.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-aerol-neas-cargo\">Charge Airlines Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>codigo_cargo<\/td>\n<td>Optional<br \/>\nCharge code.<\/td>\n<\/tr>\n<tr>\n<td>descripcion_cargo<\/td>\n<td>Optional<br \/>\nCharge description.<\/td>\n<\/tr>\n<tr>\n<td>importe<\/td>\n<td>Optional (Decimal)<br \/>\nCharge amount.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-complemento-pago\">Complement Payment Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>fecha_pago<\/td>\n<td>Required<br \/>\nDate of the operation.<\/td>\n<\/tr>\n<tr>\n<td>forma_de_pago<\/td>\n<td>Required<br \/>\nWay to pay.<\/td>\n<\/tr>\n<tr>\n<td>moneda_p<\/td>\n<td>Required (Decimal)<br \/>\nCharge amount.<\/td>\n<\/tr>\n<tr>\n<td>tipo_cambio_p<\/td>\n<td>Required (Decimal)<br \/>\nExchange rate of the currency in which the sale was made. 1.00 in case the currency is MXN.<\/td>\n<\/tr>\n<tr>\n<td>monto<\/td>\n<td>Required (Decimal)<br \/>\nPayment amount.<\/td>\n<\/tr>\n<tr>\n<td>num_operacion<\/td>\n<td>Optional (1-100 Alphanumeric)<br \/>\nPayment number.<\/td>\n<\/tr>\n<tr>\n<td>rfc_emisor_cta_ord<\/td>\n<td>Optional<br \/>\nRFC of the issuer.<\/td>\n<\/tr>\n<tr>\n<td>nom_banco_ord_ext<\/td>\n<td>Optional (1-300 Alphanumeric)<br \/>\nName of the bank.<\/td>\n<\/tr>\n<tr>\n<td>cta_ordenante<\/td>\n<td>Optional (10-50 Alphanumeric)<br \/>\nOrdering account.<\/td>\n<\/tr>\n<tr>\n<td>rfc_emisor_cta_ben<\/td>\n<td>Beneficiary<\/td>\n<\/tr>\n<tr>\n<td>cta_beneficiario<\/td>\n<td>Optional (10-50 Alphanumeric)<br \/>\nBeneficiary account.<\/td>\n<\/tr>\n<tr>\n<td>tipo_cad_pago<\/td>\n<td>Optional (\u00fanico valor v\u00e1lido 01)<br \/>\nType of payment chain.<\/td>\n<\/tr>\n<tr>\n<td>cert_pago<\/td>\n<td>Optional (byte[])<br \/>\nPayment certificate.<\/td>\n<\/tr>\n<tr>\n<td>sello_pago<\/td>\n<td>Optional (byte[])<br \/>\nPayment stamp.<\/td>\n<\/tr>\n<tr>\n<td>cad_pago<\/td>\n<td>Optional (1-8192 Alphanumeric)<br \/>\nChain.<\/td>\n<\/tr>\n<tr>\n<td>docto_relacionados<\/td>\n<td>Optional (Arrangement <a href=\"about:reader?url=https:\/\/www.openpay.mx\/docs\/api\/?shell#objeto-doctorelacionado\">DoctoRelacionado Object<\/a>).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-complemento-donatarias\">Complement Donee Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>no_autorizacion<\/td>\n<td>Required<br \/>\nAuthorization number<\/td>\n<\/tr>\n<tr>\n<td>fecha_autorizacion<\/td>\n<td>Required<br \/>\nAuthorization date (YYYY-MM-DD)<\/td>\n<\/tr>\n<tr>\n<td>leyenda<\/td>\n<td>Required<br \/>\nCaption<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-respuesta-de-solicitud-de-generaci-n\">Request Response Generation Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>invoice_id<\/td>\n<td>Identifier of the invoice sent in the request.<\/td>\n<\/tr>\n<tr>\n<td>request_id<\/td>\n<td>Request ID generated by Openpay.<\/td>\n<\/tr>\n<tr>\n<td>date<\/td>\n<td>Date on which the generation was requested<\/td>\n<\/tr>\n<tr>\n<td>status<\/td>\n<td>PENDING, OK, ERROR.<\/td>\n<\/tr>\n<tr>\n<td>fiscal_status<\/td>\n<td>ACTIVE, CANCELLED.<\/td>\n<\/tr>\n<tr>\n<td>message<\/td>\n<td>Status description.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"objeto-notificaciones\">Notifications Object<\/h2>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>invoice_id<\/td>\n<td>Identifier of the invoice sent in the request.<\/td>\n<\/tr>\n<tr>\n<td>serie<\/td>\n<td>Invoice series.<\/td>\n<\/tr>\n<tr>\n<td>folio<\/td>\n<td>Folio of the invoice.<\/td>\n<\/tr>\n<tr>\n<td>transaction_id<\/td>\n<td>Openpay transaction identifier linked to the invoice.<\/td>\n<\/tr>\n<tr>\n<td>creation_date<\/td>\n<td>Application date.<\/td>\n<\/tr>\n<tr>\n<td>issue_date<\/td>\n<td>Issue date of the invoice.<\/td>\n<\/tr>\n<tr>\n<td>uuid<\/td>\n<td>UUID of the invoice.<\/td>\n<\/tr>\n<tr>\n<td>receiver_rfc<\/td>\n<td>RFC of the invoice recipient.<\/td>\n<\/tr>\n<tr>\n<td>total<\/td>\n<td>Total invoice<\/td>\n<\/tr>\n<tr>\n<td>subtotal<\/td>\n<td>Subtotal of the invoice<\/td>\n<\/tr>\n<tr>\n<td>status<\/td>\n<td>PENDING, OK, ERROR.<\/td>\n<\/tr>\n<tr>\n<td>fiscal_status<\/td>\n<td>ACTIVE, CANCELLED.<\/td>\n<\/tr>\n<tr>\n<td>cancellation_date<\/td>\n<td>Date of cancellation of the invoice in case it is canceled.<\/td>\n<\/tr>\n<tr>\n<td>public_xml_link<\/td>\n<td>Link to download the XML of the invoice.<\/td>\n<\/tr>\n<tr>\n<td>public_pdf_link<\/td>\n<td>Link to download the PDF of the invoice.<\/td>\n<\/tr>\n<tr>\n<td>link_expiration_date<\/td>\n<td>Expiration of the download leagues, once expired the xml \/ pdf can be downloaded from the dashboard.<\/td>\n<\/tr>\n<tr>\n<td>message<\/td>\n<td>Detail of the status of the invoice.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>","protected":false},"excerpt":{"rendered":"<p>Introducci\u00f3n La API de Openpay est\u00e1 dise\u00f1a sobre REST, por lo tanto encontrar\u00e1s que las URL est\u00e1n orientadas a recursos y se usa c\u00f3digos de respuesta HTTP para indicar los errores en la API. Todas las respuestas de la API est\u00e1n en formato JSON, incluyendo errores. En el caso de usar los clientes existentes del&hellip;&nbsp;<a href=\"https:\/\/documents-mx-dev.opdevhm.com\/en\/api\" rel=\"bookmark\">Read More &raquo;<span class=\"screen-reader-text\">API<\/span><\/a><\/p>","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"elementor_header_footer","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"neve_meta_sidebar":"full-width","neve_meta_container":"","neve_meta_enable_content_width":"on","neve_meta_content_width":100,"neve_meta_title_alignment":"","neve_meta_author_avatar":"","neve_post_elements_order":"","neve_meta_disable_header":"","neve_meta_disable_footer":"","neve_meta_disable_title":"","footnotes":""},"class_list":["post-3824","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v23.8 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>API | Openpay<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/documents-mx-dev.opdevhm.com\/en\/api\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"API | Openpay\" \/>\n<meta property=\"og:description\" content=\"Introducci\u00f3n La API de Openpay est\u00e1 dise\u00f1a sobre REST, por lo tanto encontrar\u00e1s que las URL est\u00e1n orientadas a recursos y se usa c\u00f3digos de respuesta HTTP para indicar los errores en la API. Todas las respuestas de la API est\u00e1n en formato JSON, incluyendo errores. En el caso de usar los clientes existentes del&hellip;&nbsp;Read More &raquo;API\" \/>\n<meta property=\"og:url\" content=\"https:\/\/documents-mx-dev.opdevhm.com\/en\/api\/\" \/>\n<meta property=\"og:site_name\" content=\"Openpay\" \/>\n<meta property=\"article:modified_time\" content=\"2024-07-04T15:30:14+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/documents.openpay.mx\/wp-content\/uploads\/2022\/02\/openpay-color.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"69 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/documents-mx-dev.opdevhm.com\/api\",\"url\":\"https:\/\/documents-mx-dev.opdevhm.com\/api\",\"name\":\"API | Openpay\",\"isPartOf\":{\"@id\":\"https:\/\/documents-mx-dev.opdevhm.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/documents-mx-dev.opdevhm.com\/api#primaryimage\"},\"image\":{\"@id\":\"https:\/\/documents-mx-dev.opdevhm.com\/api#primaryimage\"},\"thumbnailUrl\":\"https:\/\/documents.openpay.mx\/wp-content\/uploads\/2022\/02\/openpay-color.png\",\"datePublished\":\"2021-03-25T20:13:50+00:00\",\"dateModified\":\"2024-07-04T15:30:14+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/documents-mx-dev.opdevhm.com\/api#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/documents-mx-dev.opdevhm.com\/api\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/documents-mx-dev.opdevhm.com\/api#primaryimage\",\"url\":\"https:\/\/documents.openpay.mx\/wp-content\/uploads\/2022\/02\/openpay-color.png\",\"contentUrl\":\"https:\/\/documents.openpay.mx\/wp-content\/uploads\/2022\/02\/openpay-color.png\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/documents-mx-dev.opdevhm.com\/api#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Inicio\",\"item\":\"https:\/\/documents-mx-dev.opdevhm.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/documents-mx-dev.opdevhm.com\/#website\",\"url\":\"https:\/\/documents-mx-dev.opdevhm.com\/\",\"name\":\"Openpay\",\"description\":\"Openpay a BBVA Company\",\"publisher\":{\"@id\":\"https:\/\/documents-mx-dev.opdevhm.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/documents-mx-dev.opdevhm.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/documents-mx-dev.opdevhm.com\/#organization\",\"name\":\"Openpay Soporte\",\"url\":\"https:\/\/documents-mx-dev.opdevhm.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/documents-mx-dev.opdevhm.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/documents-mx-dev.opdevhm.com\/wp-content\/uploads\/2020\/05\/logo.png\",\"contentUrl\":\"https:\/\/documents-mx-dev.opdevhm.com\/wp-content\/uploads\/2020\/05\/logo.png\",\"width\":290,\"height\":90,\"caption\":\"Openpay Soporte\"},\"image\":{\"@id\":\"https:\/\/documents-mx-dev.opdevhm.com\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"API | Openpay","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/documents-mx-dev.opdevhm.com\/en\/api\/","og_locale":"en_US","og_type":"article","og_title":"API | Openpay","og_description":"Introducci\u00f3n La API de Openpay est\u00e1 dise\u00f1a sobre REST, por lo tanto encontrar\u00e1s que las URL est\u00e1n orientadas a recursos y se usa c\u00f3digos de respuesta HTTP para indicar los errores en la API. Todas las respuestas de la API est\u00e1n en formato JSON, incluyendo errores. En el caso de usar los clientes existentes del&hellip;&nbsp;Read More &raquo;API","og_url":"https:\/\/documents-mx-dev.opdevhm.com\/en\/api\/","og_site_name":"Openpay","article_modified_time":"2024-07-04T15:30:14+00:00","og_image":[{"url":"https:\/\/documents.openpay.mx\/wp-content\/uploads\/2022\/02\/openpay-color.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"69 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/documents-mx-dev.opdevhm.com\/api","url":"https:\/\/documents-mx-dev.opdevhm.com\/api","name":"API | Openpay","isPartOf":{"@id":"https:\/\/documents-mx-dev.opdevhm.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/documents-mx-dev.opdevhm.com\/api#primaryimage"},"image":{"@id":"https:\/\/documents-mx-dev.opdevhm.com\/api#primaryimage"},"thumbnailUrl":"https:\/\/documents.openpay.mx\/wp-content\/uploads\/2022\/02\/openpay-color.png","datePublished":"2021-03-25T20:13:50+00:00","dateModified":"2024-07-04T15:30:14+00:00","breadcrumb":{"@id":"https:\/\/documents-mx-dev.opdevhm.com\/api#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/documents-mx-dev.opdevhm.com\/api"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/documents-mx-dev.opdevhm.com\/api#primaryimage","url":"https:\/\/documents.openpay.mx\/wp-content\/uploads\/2022\/02\/openpay-color.png","contentUrl":"https:\/\/documents.openpay.mx\/wp-content\/uploads\/2022\/02\/openpay-color.png"},{"@type":"BreadcrumbList","@id":"https:\/\/documents-mx-dev.opdevhm.com\/api#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Inicio","item":"https:\/\/documents-mx-dev.opdevhm.com\/"},{"@type":"ListItem","position":2,"name":"API"}]},{"@type":"WebSite","@id":"https:\/\/documents-mx-dev.opdevhm.com\/#website","url":"https:\/\/documents-mx-dev.opdevhm.com\/","name":"Openpay","description":"Openpay a BBVA Company","publisher":{"@id":"https:\/\/documents-mx-dev.opdevhm.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/documents-mx-dev.opdevhm.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/documents-mx-dev.opdevhm.com\/#organization","name":"Openpay Soporte","url":"https:\/\/documents-mx-dev.opdevhm.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/documents-mx-dev.opdevhm.com\/#\/schema\/logo\/image\/","url":"https:\/\/documents-mx-dev.opdevhm.com\/wp-content\/uploads\/2020\/05\/logo.png","contentUrl":"https:\/\/documents-mx-dev.opdevhm.com\/wp-content\/uploads\/2020\/05\/logo.png","width":290,"height":90,"caption":"Openpay Soporte"},"image":{"@id":"https:\/\/documents-mx-dev.opdevhm.com\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/documents-mx-dev.opdevhm.com\/en\/wp-json\/wp\/v2\/pages\/3824","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/documents-mx-dev.opdevhm.com\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/documents-mx-dev.opdevhm.com\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/documents-mx-dev.opdevhm.com\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/documents-mx-dev.opdevhm.com\/en\/wp-json\/wp\/v2\/comments?post=3824"}],"version-history":[{"count":0,"href":"https:\/\/documents-mx-dev.opdevhm.com\/en\/wp-json\/wp\/v2\/pages\/3824\/revisions"}],"wp:attachment":[{"href":"https:\/\/documents-mx-dev.opdevhm.com\/en\/wp-json\/wp\/v2\/media?parent=3824"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}