> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-colombia.wallib.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-colombia.wallib.io/_mcp/server.

# Send Webhook Transaction

POST https://third/v1/provider/webhook/transactions
Content-Type: application/json

Simulates a webhook event for a specific transaction, used for testing webhook integrations.

Triggers a webhook notification for the given transaction with the specified event status. This is useful for verifying that your webhook endpoint correctly handles all possible transaction lifecycle events without waiting for real transactions to occur.

**Authentication:** Bearer token (`{{JWT_LOGIN}}`) + `x-api-key` header.

**Key body fields**

* `transactionId`: The ID of the transaction to simulate the event for.
* `event`: The transaction status event to trigger. Supported values: `QUOTED`, `PENDING`, `FAILED`, `EXPIRED`, `COMPLETED`, `CANCELLED`.

Reference: https://docs-colombia.wallib.io/wallib-payments-api-colombia/send-webhook-transaction

## Request

### Headers

- `x-api-key` (string, optional)

### Body (application/json)

- `string`

## Response

### 200

OK

- `message` (string, required)

## Examples

**Request**

```json
"{\n    \"event\": \"COMPLETED\", // QUOTED, PENDING, FAILED, EXPIRED, COMPLETED, CANCELLED \n    \"transactionId\": \"2b617398-7088-4203-863b-f20cf285bb8b\"\n}"
```

**Response**

```json
{
  "message": "Webhook notification sent successfully"
}
```

**SDK Code**

```python Send Webhook Transaction_example
import requests

url = "https://third/v1/provider/webhook/transactions"

payload = "{
    \"event\": \"COMPLETED\", // QUOTED, PENDING, FAILED, EXPIRED, COMPLETED, CANCELLED 
    \"transactionId\": \"2b617398-7088-4203-863b-f20cf285bb8b\"
}"
headers = {
    "x-api-key": "{{X_API_KEY}}",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript Send Webhook Transaction_example
const url = 'https://third/v1/provider/webhook/transactions';
const options = {
  method: 'POST',
  headers: {'x-api-key': '{{X_API_KEY}}', 'Content-Type': 'application/json'},
  body: '"{\n    \"event\": \"COMPLETED\", // QUOTED, PENDING, FAILED, EXPIRED, COMPLETED, CANCELLED \n    \"transactionId\": \"2b617398-7088-4203-863b-f20cf285bb8b\"\n}"'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Send Webhook Transaction_example
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://third/v1/provider/webhook/transactions"

	payload := strings.NewReader("\"{\\n    \\\"event\\\": \\\"COMPLETED\\\", // QUOTED, PENDING, FAILED, EXPIRED, COMPLETED, CANCELLED \\n    \\\"transactionId\\\": \\\"2b617398-7088-4203-863b-f20cf285bb8b\\\"\\n}\"")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "{{X_API_KEY}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Send Webhook Transaction_example
require 'uri'
require 'net/http'

url = URI("https://third/v1/provider/webhook/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '{{X_API_KEY}}'
request["Content-Type"] = 'application/json'
request.body = "\"{\\n    \\\"event\\\": \\\"COMPLETED\\\", // QUOTED, PENDING, FAILED, EXPIRED, COMPLETED, CANCELLED \\n    \\\"transactionId\\\": \\\"2b617398-7088-4203-863b-f20cf285bb8b\\\"\\n}\""

response = http.request(request)
puts response.read_body
```

```java Send Webhook Transaction_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://third/v1/provider/webhook/transactions")
  .header("x-api-key", "{{X_API_KEY}}")
  .header("Content-Type", "application/json")
  .body("\"{\\n    \\\"event\\\": \\\"COMPLETED\\\", // QUOTED, PENDING, FAILED, EXPIRED, COMPLETED, CANCELLED \\n    \\\"transactionId\\\": \\\"2b617398-7088-4203-863b-f20cf285bb8b\\\"\\n}\"")
  .asString();
```

```php Send Webhook Transaction_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://third/v1/provider/webhook/transactions', [
  'body' => '"{\\n    \\"event\\": \\"COMPLETED\\", // QUOTED, PENDING, FAILED, EXPIRED, COMPLETED, CANCELLED \\n    \\"transactionId\\": \\"2b617398-7088-4203-863b-f20cf285bb8b\\"\\n}"',
  'headers' => [
    'Content-Type' => 'application/json',
    'x-api-key' => '{{X_API_KEY}}',
  ],
]);

echo $response->getBody();
```

```csharp Send Webhook Transaction_example
using RestSharp;

var client = new RestClient("https://third/v1/provider/webhook/transactions");
var request = new RestRequest(Method.POST);
request.AddHeader("x-api-key", "{{X_API_KEY}}");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "\"{\\n    \\\"event\\\": \\\"COMPLETED\\\", // QUOTED, PENDING, FAILED, EXPIRED, COMPLETED, CANCELLED \\n    \\\"transactionId\\\": \\\"2b617398-7088-4203-863b-f20cf285bb8b\\\"\\n}\"", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift Send Webhook Transaction_example
import Foundation

let headers = [
  "x-api-key": "{{X_API_KEY}}",
  "Content-Type": "application/json"
]
let parameters = "{
    \"event\": \"COMPLETED\", // QUOTED, PENDING, FAILED, EXPIRED, COMPLETED, CANCELLED 
    \"transactionId\": \"2b617398-7088-4203-863b-f20cf285bb8b\"
}" as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://third/v1/provider/webhook/transactions")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```