Skip to content

Lock Customer

PATCH /customer/lock

Description URL Response Format Request Method Authentication
Lock a customer so it can't be edited by Trackfinity. It can still be updated based on posts from the advertiser https://domain/api/customer/lock JSON PATCH HTTP headers

Parameters

Paremeters must be sent with the request body. The examples below show the parameters sent as x-www-form-urlencoded. You need to pass either customer_id or subscription_id or orderid for customer lookup otherwise the call will fail.

Name Description Type Required
customer_id pass in the customer_id of the customer to modify string no
subscription_id pass in the subscription of the customer to modify string no
orderid pass in the event id of one of the transactions associated with the customer to modify string no

Example Request

PATCH

https://domain/api/customer/lock

Response:

true

Example Code

php

<?php
$curl = curl_init();

$data = array(
    'customer_id' => 191,
);

$url = 'http://domain/api/customer/lock';

$headers = array(
    'api-key: 44b5498dbcb481a0d00b404c0169af62',
    'api-username: tf_admin'
);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, "PATCH");
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_URL, $url);

$resp = curl_exec($curl);
//dumps an associative array representation of the json
var_dump(json_decode($resp, true));
// Close request to clear up some resources
curl_close($curl);
?>

Python

This example requires pip and the request library which can be installed via pip by: 'pip install requests'.

import requests
import json

url = 'http://domain/api/customer/lock'

payload = {
    'customer_id': 191,
}


headers = {
        'api-key': '44b5498dbcb481a0d00b404c0169af62',
        'api-username': 'tf_admin'
        }

res = requests.patch(url, data=payload, headers=headers)
print res.json()

node.js

This example requires npm and the request module which can be installed via npm by: 'npm install request'.

var request = require('request');

data = {
    'customer_id': 191,
}

var options = {
    url: 'http://domain/api/customer/lock',
    method: 'PATCH',
    form: data,
    json: true,
    headers: {
        'api-key': '44b5498dbcb481a0d00b404c0169af62',
        'api-username': 'tf_admin'
    }
};

function callback(error, response, body) {
    if (!error && response.statusCode == 200) {
        console.log(body);
    }
    else{
        console.log(body);
    }

}

request(options, callback);

Curl

curl -X PATCH 'http://domain/api/customer/lock' -H "api-key: 44b5498dbcb481a0d00b404c0169af62" -H "api-username: tf_admin" -H "Content-Type: application/x-www-form-urlencoded" -d 'customer_id=191'