document transaction failure API (bug 862406)