# Update ## Update `PATCH` `https://api.payvalida.com/api/v3/porders` `Sandbox URL: https://api-test.payvalida.com/api/v3/`**`porders`**\ \ Allows the modification of an existing order, for example, extending its life (expiration date), amount, description, reference, etc. #### Path Parameters | Name | Type | Description | | ----------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | merchant | string | ID of the commerce in Payvalida. Max. 50 characters | | email | string | Customer's email. It's used to send notification of the billing. Max. 100 characters. | | country | number | Country code. 3 characters. | | order | string | Order ID, generated by the commerce. Max. 20 characters. | | reference | number | Reference number used by the customer to pay the order. | | money | string | Currency's code of the order. 3 characters. | | amount | number | Order's amount. | | description | string | Short description of the order. Max. 500 characters. | | method | string | Payment method selected by the customer. Max. 25 characters. | | language | string | Language of the messages and responses. 2 characters. | | recurrent | boolean | Indicated whether the order is recurrent. | | expiration | string | Expiration date in format DD/MM/YYYY. Fecha de expiración de la orden en formato DD/MM/AAAA. It can't neither surpass 30 days nor be from a date before the registration of the order. | | iva | number | Percentage amount of VAT/IVA of the order. | | checksum | string |

Checksum encoded in SHA512
(email+country+order+money+amount+FIXED\_HASH). Max. 512 caracteres.

| {% tabs %} {% tab title="200 The execution returns a JSON following this structure:" %} ```css { "CODE":"0000", "DATA":{ "OrdenID":"p0000201", "Monto":"55000.0", "PVordenID":"95601", "Referencia":"989898101", "Operacion":"ACTUALIZADO", "checkout":"checkout.payvalida.com/?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJNRVJDSEFOVF9DRUwiOiIzMTc2ODI3MzQxIiwiT1JERVJfTUVUSE9EIjoiZWZlY3R5IiwiTUVSQ0hBTlRfQ09ERSI6MjU0LCJNRVJDSEFOVF9FTUFJTCI6ImhyZXN0cmVwb0BwYXl2YWxpZGEuY29tIiwiaXNzIjoiYXV0aDAiLCJNRVJDSEFOVF9MT0dPIjoiaHR0cHM6Ly9zMy5hbWF6b25hd3MuY29tL3ZhbGlkZGF3ZWIvZXZlbnRvcy9mZW5hbGNvYnJhLnBuZyIsIk1FUkNIQU5UX1VSTF9SRVRVUk4iOiJ3d3cucGludmFsaWRkYS5jb20uY28iLCJNRVJDSEFOVF9OQU1FIjoiSGVybmFuIFJwbyAoQ09MKSIsIk9SREVSX0JSSUVGIjoiVGVzdCBSRVNUZnVsbCBQdXJjaGFzZSBPcmRlciBQT1NUIiwiTUVSQ0hBTlRfVEVMIjoiMjg4MDUzOSIsIk9SREVSX0NVUlJFTkNZIjoiQ09QIiwiT1JERVJfQU1PVVQiOiIxMCwwMDAuMDAiLCJleHAiOjE1MzA0MDE1MzgsIk9SREVSX1JFRkVSRU5DRSI6IjQyMzEzIn0.QVsZwm-2BIkK-5RgrAX2NuwGqmHSNHD_zw91i1hcSc8" }, "DESC":"OK" } ``` {% endtab %} {% endtabs %} {% hint style="success" %} The commerce (merchant) id and the FIXED\_HASH are provided when you [create an account](http://registro.payvalida.com) in our platform. Sent data is verified and updated if the parameter is different to the original order's. {% endhint %} {% hint style="danger" %} In order to update an order, it is required to be in **PENDING (PENDIENTE)** status, otherwise you won't be able to modify it. {% endhint %} ## Examples * **Request** ```bash curl --location --request PATCH 'https://api-test.payvalida.com/api/v3/porders' \ --header 'Content-Type: application/json' \ --data-raw '{ "merchant": "kuanto", "email": "someone@example.com", "country": 343, "order": "999999991", "reference": "46534512", "money": "COP", "amount": "9500", "description": "Orden de prueba", "method": "", "language": "es", "recurrent": true, "expiration": "27/12/2020", "iva": "0", "checksum": "1AC89E7089355B5069222C01779431A192FC4D459C25584D69B64ABBF605FE7CB54A015296A39D234CA9B94FF9F068423AC1E00F5A319EB18F2167B97C8A0BB1", "user_di": "94320444", "user_type_di": "CC", "user_name": "NombreUsuario", "redirect_timeout": "300000" }' ``` * **Go** ```go package main import ( "bytes" "crypto/sha512" "encoding/hex" "encoding/json" "fmt" "io/ioutil" "math/rand" "net/http" "time" ) type Request struct { Country int `json:"country,omitempty"` Email string `json:"email,omitempty"` Merchant string `json:"merchant,omitempty"` Order string `json:"order,omitempty"` Reference string `json:"reference,omitempty"` Money string `json:"money,omitempty"` Amount string `json:"amount,omitempty"` Description string `json:"description,omitempty"` Language string `json:"language,omitempty"` Recurrent bool `json:"recurrent,omitempty"` Expiration string `json:"expiration,omitempty"` Method string `json:"method,omitempty"` Iva string `json:"iva,omitempty"` Checksum string `json:"checksum,omitempty"` UserDI string `json:"user_di,omitempty"` UserTypeDI string `json:"user_type_di,omitempty"` RedirectTimeout string `json:"redirect_timeout,omitempty"` UserName string `json:"user_name,omitempty"` } func main() { url := "https://api-test.payvalida.com/api/v3/porders" method := "PATCH" email := "someone@example.com" country := "343" order := "test" + fmt.Sprint(rand.Intn(999999999)) money := "COP" amount := "20000" fixedHash := "xxccc_b0b20707cca2b283b5844e77cadf2b5813bd923362b91583c95b736c8763937c0e0df27e9b730c404eeac6484666430f6042c043089135e8d3e76f2e86a82c38" Paysha512 := sha512.Sum512([]byte(email + country + order + money + amount + fixedHash)) checksum := hex.EncodeToString(Paysha512[:]) date := time.Now() expiration := date.AddDate(0, 0, 2) request := Request{ Country: 343, Email: email, Merchant: "kuanto", Order: order, Reference: "", Money: money, Amount: amount, Description: "Test pruebas unitarias", Language: "es", Recurrent: false, Expiration: expiration.Format("02/01/2006"), Method: "", Iva: "0", Checksum: checksum, UserDI: "90000000", UserTypeDI: "CC", RedirectTimeout: "150000", UserName: "devPayvalida", } json, err := json.Marshal(request) if err != nil { fmt.Println(err) return } client := &http.Client{} req, err := http.NewRequest(method, url, bytes.NewBuffer(json)) if err != nil { fmt.Println(err) return } req.Header.Add("Content-Type", "application/json") res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := ioutil.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) } ``` * **PHP** ```php "https://api-test.payvalida.com/api/v3/porders", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "PATCH", CURLOPT_POSTFIELDS =>"{\n \"merchant\": \"kuanto\",\n \"email\": \"someone@example.com\",\n \"country\": 343,\n \"order\": \"999999991\",\n \"reference\": \"46534512\",\n \"money\": \"COP\",\n \"amount\": \"9500\",\n \"description\": \"Orden de prueba\",\n \"method\": \"\",\n \"language\": \"es\",\n \"recurrent\": true,\n \"expiration\": \"27/12/2020\",\n \"iva\": \"0\",\n \"checksum\": \"1AC89E7089355B5069222C01779431A192FC4D459C25584D69B64ABBF605FE7CB54A015296A39D234CA9B94FF9F068423AC1E00F5A319EB18F2167B97C8A0BB1\",\n \"user_di\": \"94320444\",\n \"user_type_di\": \"CC\",\n \"user_name\": \"NombreUsuario\",\n \"redirect_timeout\": \"300000\"\n}", CURLOPT_HTTPHEADER => array( "Content-Type: application/json" ), )); $response = curl_exec($curl); curl_close($curl); echo $response; ``` * **Java** ```java Unirest.setTimeouts(0, 0); HttpResponse response = Unirest.patch("https://api-test.payvalida.com/api/v3/porders") .header("Content-Type", "application/json") .body("{\n \"merchant\": \"kuanto\",\n \"email\": \"someone@example.com\",\n \"country\": 343,\n \"order\": \"999999991\",\n \"reference\": \"46534512\",\n \"money\": \"COP\",\n \"amount\": \"9500\",\n \"description\": \"Orden de prueba\",\n \"method\": \"\",\n \"language\": \"es\",\n \"recurrent\": true,\n \"expiration\": \"27/12/2020\",\n \"iva\": \"0\",\n \"checksum\": \"1AC89E7089355B5069222C01779431A192FC4D459C25584D69B64ABBF605FE7CB54A015296A39D234CA9B94FF9F068423AC1E00F5A319EB18F2167B97C8A0BB1\",\n \"user_di\": \"94320444\",\n \"user_type_di\": \"CC\",\n \"user_name\": \"NombreUsuario\",\n \"redirect_timeout\": \"300000\"\n}") .asString(); ``` * **JavaScript** ```javascript var myHeaders = new Headers(); myHeaders.append("Content-Type", "application/json"); var raw = JSON.stringify({"merchant":"kuanto","email":"someone@example.com","country":343,"order":"999999991","reference":"46534512","money":"COP","amount":"9500","description":"Orden de prueba","method":"","language":"es","recurrent":true,"expiration":"27/12/2020","iva":"0","checksum":"1AC89E7089355B5069222C01779431A192FC4D459C25584D69B64ABBF605FE7CB54A015296A39D234CA9B94FF9F068423AC1E00F5A319EB18F2167B97C8A0BB1","user_di":"94320444","user_type_di":"CC","user_name":"NombreUsuario","redirect_timeout":"300000"}); var requestOptions = { method: 'PATCH', headers: myHeaders, body: raw, redirect: 'follow' }; fetch("https://api-test.payvalida.com/api/v3/porders", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error)); ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.payvalida.com/api-recaudo/api-recaudo-en/purchase-orders/update.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.